Chris Sewell

I would point out: https://github.com/executablebooks/markdown-it-py, which has tables, among other extensions, and is already used in https://myst-parser.readthedocs.io, https://myst-nb.readthedocs.io/en/latest/ and https://jupyterbook.org 😁

Yeh, it is a bit of a weird one, because there is technically nothing to actually link to for the captions. I had the same issue with the panel links,...

I have to say, I do prefer the RTD toctree bar though, where you can quickly link to anywhere in the documentation (to depth 2), e.g. in https://pydata-sphinx-theme.readthedocs.io/en/latest/index.html, it feels...

I guess essentially what I'd like is the bulk of the pydata theme, but with the "fixed" left toctree from the RTD theme. At least for the amount/depth of content...

Sorry this is mainly just me thinking out loud... I think the top banner works better as part of a larger website, where your "documentation" is a section of the...

> What do you understand exactly under "the bulk" ? I guess just the general CSS, plus the right "page level" ToC

BTW I was recently pointed toward this "search as you type" extension https://readthedocs-sphinx-search.readthedocs.io which is pretty nice. I haven't check yet if it works already with the pydata theme, but...

nice!

> convince RTD to special-case jupyter books What do you mean by special case?

> unless you know of a way to use custom build commands with RTD? Yeh not that I know, so sounds like a good idea