Re:Ask HN: What are some unpopular technologies you wish peo...
by lrobinovitch on Saturday December 02, 2023 @11:57AM
(#38499940)
Myst has parity with most reST features and is equivalent to markdown for users not using those features: https://myst-parser.readthedocs.io/en/v0.13.7/using/syntax.h...
Re:Ask HN: What are some unpopular technologies you wish peo...
by kaycebasques on Saturday December 02, 2023 @12:15PM
(#38500098)
Oh cool I need to revisit MyST then. I thought it didn't support cross-references but it looks like I'm wrong: https://myst-parser.readthedocs.io/en/v0.13.7/using/syntax.h...
I will have to dig into exactly how much parity we're talking here but if it's very strong parity then I redact my previous statement
Thanks for correcting me!
Re:Ask HN: What are some unpopular technologies you wish peo...
by jw_cook on Sunday December 03, 2023 @01:59AM
(#38505395)
It works with all docutils and Sphinx roles, and almost all directives, including extensions.
A notable exception is autodoc (automodule, autoclass, etc.), and any other directives that generate more rST. The current workaround is to use eval-rst:
https://myst-parser.readthedocs.io/en/latest/syntax/code_and...
Some more discussion about that in these issues:
From Sphinx's Getting Started page:
> Much of Sphinx’s power comes from the richness of its default plain-text markup format, reStructuredText, along with its significant extensibility capabilities.
https://www.sphinx-doc.org/en/master/usage/quickstart.html#g...