3 ms·
I've used Sphinx quite a bit, the syntax is a bit fugly. For markdown's [text](url) one uses `text <url>`_ ...
by jjgreen 3y ago
I've used Sphinx quite a bit, the syntax is a bit fugly. For markdown's
[text](url)
one uses
`text <url>`_
...
- kaycebasques 3y agoirobinovitch just corrected me that the library that provides Markdown support for Sphinx supports the features [1] that I care about; have to dig into the details but if the feature parity is very good and you strongly prefer Markdown over reST then I would say... go for the Markdown! [1] e.g. https://myst-parser.readthedocs.io/en/v0.13.7/using/syntax.html#targets-and-cross-referencing https://myst-parser.readthedocs.io/en/v0.13.7/using/syntax.h...
- jw_cook 3y agoI think this is also one of my least favorite syntax choices in rST. I second the suggestions to use Sphinx with Markdown via MyST.