MyST: Markedly Structured Text

  • MyST: Community-driven tools for technical communication
  • Built on top of Sphinx documentation generation framework, which is written in Python. It utilizes reStructuredText (MyST incorporates the “good part” of reST).
  • “This project is an attempt at combining the simplicity and readability of Markdown with the power and flexibility of reStructuredText and the Sphinx platform.” It starts with CommonMark spec markdown spec and selectively extends features.
myst markdown (.md) ------> myst parser ---+
                                           |
                                           +-->Sphinx document (docutils)
                                           |
reStructuredText (.rst) --> rst parser ----+

Alternatively, there is MyST-Parser, which utilizes markdown-it-py to parse MyST documents into tokens (its own AST representation). Sphinx renderer and docutils renderers can be used for converting it to other formats.