top | item 38499940 (no title) lrobinovitch | 2 years ago 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... discuss order hn newest kaycebasques|2 years ago 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 statementThanks for correcting me! jw_cook|2 years ago 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/163https://github.com/sphinx-doc/sphinx/issues/8018
kaycebasques|2 years ago 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 statementThanks for correcting me! jw_cook|2 years ago 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/163https://github.com/sphinx-doc/sphinx/issues/8018
jw_cook|2 years ago 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/163https://github.com/sphinx-doc/sphinx/issues/8018
kaycebasques|2 years ago
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!
jw_cook|2 years ago
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