myst-parser
An extended [CommonMark](https://spec.commonmark.org/) compliant parser,
Decision gist · record as of 2026-08-14
Yes. MyST-Parser is actively maintained, has no known vulnerabilities, installs with low friction, and solves a real problem for teams wanting Markdown in Sphinx. It's a mature Beta-status tool (in production use since 2020) with broad Python support. Install it if you want to author Sphinx docs in Markdown or migrate an existing project away from reStructuredText.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later and an existing Sphinx documentation project.
- Low friction installation with a pure-Python wheel.
- Actively maintained (last commit 2026-08-10, 93 days since release), supports current Python versions (3.11–3.14), and has a stable foundation with 886 repository stars.
License · maintenance · safety
permissive license (permissive) — Licensed under MIT (permissive), so you can use, modify, and distribute the package freely with minimal restrictions.
last release 2026-05-13 (93 days) · last repo commit 2026-08-10 · 886 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 8,253,083 downloads/mo, #1,642 on PyPI
Alternatives
Verify before relying
pip install myst-parser
# In Sphinx conf.py:
extensions = ["myst_parser"]
# Then write .md files in your Sphinx project- Whether MyST syntax extensions (e.g., for cross-references, code directives) are documented and stable for production use.
- Performance characteristics when parsing large or deeply nested Markdown documents.
- Compatibility matrix with specific Sphinx versions beyond the classifier range.
What it is and what it does
MyST-Parser is a Markdown parser and Sphinx extension that lets you write technical documentation in Markdown instead of reStructuredText. It implements an extended CommonMark dialect designed for flexibility and extensibility, built on markdown-it-py and integrated with Sphinx's rendering pipeline. The package acts as a bridge between Markdown's simplicity and Sphinx's documentation capabilities, parsing .md files through docutils and Jinja2 templating to produce the same output as native Sphinx sources.
You install it as a Sphinx extension by adding it to your conf.py, then write .md files in your documentation tree. It handles YAML frontmatter, code directives, cross-references, and other technical markup common in API docs and tutorials. The parser depends on markdown-it-py for tokenization, mdit-py-plugins for extended syntax, and pyyaml for metadata extraction.
Use it for
- Convert an existing reStructuredText Sphinx project to Markdown without rewriting all source files.
- Author technical documentation in Markdown while keeping Sphinx's build system and theme infrastructure.
- Mix Markdown and reStructuredText sources in a single Sphinx project for gradual migration.
- Use Markdown's simpler syntax for tutorials and guides while maintaining cross-references and code examples.
- Extend Markdown with Sphinx directives (like :doc:, :ref:) for linking and API documentation.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
MyST-Parser is actively maintained, has no known vulnerabilities, installs with low friction, and solves a real problem for teams wanting Markdown in Sphinx. It's a mature Beta-status tool (in production use since 2020) with broad Python support. Install it if you want to author Sphinx docs in Markdown or migrate an existing project away from reStructuredText.
Install
myst-parser on PyPI
Before you install
Low friction installation with a pure-Python wheel. Actively maintained (last commit 2026-08-10, 93 days since release), supports current Python versions (3.11–3.14), and has a stable foundation with 886 repository stars.
Requires Python 3.11 or later and an existing Sphinx documentation project.
License in practice
Licensed under MIT (permissive), so you can use, modify, and distribute the package freely with minimal restrictions.
Quickstart
pip install myst-parser
# In Sphinx conf.py:
extensions = ["myst_parser"]
# Then write .md files in your Sphinx projectVerify before relying
- Whether MyST syntax extensions (e.g., for cross-references, code directives) are documented and stable for production use.
- Performance characteristics when parsing large or deeply nested Markdown documents.
- Compatibility matrix with specific Sphinx versions beyond the classifier range.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 6 packagesdocutilsjinja2markdown-it-pymdit-py-pluginspyyamlsphinx |
| Maintenance | Actively maintained 93 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 8,253,083 / month, #1,642 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaFramework :: Sphinx :: ExtensionIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Software Development :: Libraries :: Python ModulesTopic :: Text Processing :: Markup |
Evidence: myst_parser-5.1.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “markdown parser for sphinx”
- myst-parserMyST-Parser extends CommonMark-compliant Markdown with syntax for…
- recommonmarkEnables Sphinx and Docutils projects to parse and render CommonMark…
- myst-nbSphinx extension that parses and converts Jupyter Notebooks (.ipynb…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also myst-nb · recommonmark · mdformat_myst · mdit-py-plugins · markdown-it-py · mistletoe · marko · sphinx-markdown-tables · commonmark · sphinx-multitoc-numbering