Chris Sewell

> Are there already JupyterLab extensions that allow Markdown syntax extensions? This may be of relevance https://github.com/jupyterlab/jupyter-renderers

> I have the feeling that the colon (`:::`) syntax is kinda the favorite right now, but I guess there is no official statement about this. The closest to an...

> Sphinx already has a mechanism to determine this I think you are confusing what sphinx does; its only checking if the `mtime` of a file has changed, not doing...

Yeh absolutely, its just trying to get the balance right between automating the re-build logic, and having manual control to force the rebuild of aspects of the build. `-E` is...

> What makes one kind more general than the other? The interplay between the markdown parser and the parsing of content of a docutils directive. With backticks you are telling...

> You parse the contents of, say, ```{admonition} blocks with the MyST parser anyway, and not with docutils, right? Not exactly no; the content gets parsed directly (as unparsed text)...

> So you can customize the way Sphinx parses a directive without changing the directive itself? https://github.com/executablebooks/MyST-Parser/blob/a084975f02c0b4a9141f75878f78b48afa9f9b5a/myst_parser/docutils_renderer.py#L670, directive are initialised exactly the same as they are in docutils, except they...

state-machine is just the theoretical framework on which the parser is built, well technically: https://en.wikipedia.org/wiki/Pushdown_automaton > I guess with this you get correct line numbers in case of parsing errors?...

Well one of the key differences is that nbsphinx uses Pandoc to first convert Markdown text to RST text, then runs that through the RST parser (to convert to docutils...

Yeh will do. I think, as I've seen discussed a bit in the other issues here, comparing images/pdf out of matplotlib is probably not going to be robust enough anyway....