News for hackers. Stuff that matters.

A comment on Ask HN: What are some unpopular technologies you wish people knew more about?. Parent comment

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!

[ Parent | on HN ]
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:

https://github.com/executablebooks/MyST-Parser/issues/163

https://github.com/sphinx-doc/sphinx/issues/8018

[ Parent | on HN ]