MyST Parser

MyST Parser lets you write documentation in Markdown instead of reStructuredText, with full access to Sphinx directives and roles.

Setup

uv add myst-parser

conf.py

extensions = ["myst_parser"]

myst_enable_extensions = [
    "colon_fence",     # Use ::: for directives instead of ```
    "dollarmath",      # $inline$ and $$display$$ LaTeX math
    "amsmath",         # Multi-line equation environments
    "tasklist",        # - [x] checkbox task lists
    "deflist",         # Definition lists (Term\n: Definition)
    "fieldlist",       # :Key: Value metadata lists
    "substitution",    # {{variable}} template replacements
]

See also

MyST Markdown — writing syntax, colon fence usage, substitutions, and directive examples.