Arwed S.

I'll set up a mini sphinx+breathe+MyST example later, I guess that's what happens here. See also my related issue. I put a try... execpt around the line 970 locally, and...

@chrisjsewell: Could myst simply support the rst feature "citations"? https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#citations It is basic but does what we currently need, i.e. named footnotes 🙂

so your suggestion would be to use `contents` directive then?

@hukkin: I'm fine with a heading-formatter plug-in, but will most likely not have time to work on that this year. I have some doubts about your argument that the number...

@danwos: We cover that use case over our sphinx-warnings-filter extension instead of yet another config option for sphinx-needs. A [needs.extend] warning that can be configured in the sphinx warnings_filter list...

@chrisjsewell: True, I just found it out myself after thinking about the (YAML related) error message a bit. Then, I think a hint in the documentation should be added that...

They have, in two sentences: https://jupyter-notebook.readthedocs.io/en/stable/examples/Notebook/Working%20With%20Markdown%20Cells.html Their actual implementation is as primitive as the spec: Whatever is between the first and the next Dollar sign on a line will be...

True. It's not really their use case though. Anyhow, since this is not generic enough I'd rather try to convince that VS code plugin developer to add the Doxygen syntax,...

The style rules I mentioned in the original post is actually pandoc (https://pandoc.org/MANUAL.html#math ). This is less ambiguos but not perfect either. The kramdown/pandoc/paperhive syntax is much less ambiguous (https://kramdown.gettalong.org/syntax.html#math-blocks...

@doxygen I think so too, but that will only serve the few people that use that VS code plug-in (around 100.000 judging from the download count). [Pandoc style](https://pandoc.org/MANUAL.html#math) is actually...