# myst-parser

> An extended [CommonMark](https://spec.commonmark.org/) compliant parser,

- **URL**: https://www.freshcrate.ai/projects/myst-parser
- **Author**: pypi
- **Category**: Frameworks
- **Latest version**: `v5.1.0` (2026-05-13)
- **License**: Unknown
- **Source**: https://github.com/executablebooks/MyST-Parser
- **Homepage**: https://pypi.org/project/myst-parser/
- **Language**: Python
- **GitHub**: 874 stars, 229 forks
- **Registry**: pypi (`myst-parser`)
- **Tags**: `development`, `docutils`, `lexer`, `markdown`, `parser`, `pypi`, `sphinx`

## Description

# MyST-Parser

[![Github-CI][github-ci]][github-link]
[![Coverage Status][codecov-badge]][codecov-link]
[![Documentation Status][rtd-badge]][rtd-link]
[![Code style: black][black-badge]][black-link]
[![PyPI][pypi-badge]][pypi-link]
[![Conda][conda-badge]][conda-link]
[![PyPI - Downloads][install-badge]][install-link]


**MyST is a rich and extensible flavor of Markdown meant for technical documentation and publishing**.

MyST is a flavor of markdown that is designed for simplicity, flexibility, and extensibility.
This repository serves as the reference implementation of MyST Markdown, as well as a collection of tools to support working with MyST in Python and Sphinx.
It contains an extended [CommonMark](https://commonmark.org)-compliant parser using [`markdown-it-py`](https://markdown-it-py.readthedocs.io/), as well as a [Sphinx](https://www.sphinx-doc.org) extension that allows you to write MyST Markdown in Sphinx.

[**See the MyST Parser documentation for more information**](https://myst-parser.readthedocs.io/en/latest/).

## Installation

To install the MyST parser, run the following in a
[Conda environment](https://docs.conda.io) (recommended):

```bash
conda install -c conda-forge myst-parser
```

or

```bash
pip install myst-parser
```

Or for package development:

```bash
git clone https://github.com/executablebooks/MyST-Parser
cd MyST-Parser
git checkout master
pip install -e .[code_style,linkify,testing,rtd]
```

To use the MyST parser in Sphinx, simply add: `extensions = ["myst_parser"]` to your `conf.py`.

## Contributing

We welcome all contributions!
See the [Contributing Guide](https://myst-parser.readthedocs.io/en/latest/develop/index.html) for more details.

[github-ci]: https://github.com/executablebooks/MyST-Parser/workflows/continuous-integration/badge.svg?branch=master
[github-link]: https://github.com/executablebooks/MyST-Parser
[codecov-badge]: https://codecov.io/gh/executablebooks/MyST-Parser/branch/master/graph/badge.svg
[codecov-link]: https://codecov.io/gh/executablebooks/MyST-Parser
[rtd-badge]: https://readthedocs.org/projects/myst-parser/badge/?version=latest
[rtd-link]: https://myst-parser.readthedocs.io/en/latest/?badge=latest
[black-badge]: https://img.shields.io/badge/code%20style-black-000000.svg
[pypi-badge]: https://img.shields.io/pypi/v/myst-parser.svg
[pypi-link]: https://pypi.org/project/myst-parser
[conda-badge]: https://anaconda.org/conda-forge/myst-parser/badges/version.svg
[conda-link]: https://anaconda.org/conda-forge/myst-parser
[black-link]: https://github.com/ambv/black
[install-badge]: https://img.shields.io/pypi/dw/myst-parser?label=pypi%20installs
[install-link]: https://pypistats.org/packages/myst-parser

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v5.1.0` | 2026-05-13 | High | ## ✨ New Features  - ✨ Add `"alert"` syntax extension for [GFM alerts](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) (e.g. `> [!NOTE]`), see [docs](https://myst-parser.readthedocs.io/en/latest/syntax/optional.html#alerts-github-style-callouts) by @chrisjsewell in #1128 - ✨ Add `"gfm_autolink"` syntax extension for [GFM autolinks](https://github.github.com/gfm/#autolinks-extension-), se |
| `5.0.0` | 2026-04-21 | Low | Imported from PyPI (5.0.0) |
| `v5.0.0` | 2026-01-15 | Low | # MyST-Parser 5.0.0  **Release Date**: 2026-01-15  This release significantly bumps the supported versions of core dependencies:  ## ‼️ Breaking Changes  This release updates the minimum supported versions:  - **Python**: `>=3.11` (dropped Python 3.10, tests up to 3.14) - **Sphinx**: `>=8,<10` (dropped Sphinx 7, added Sphinx 9) - **Docutils**: `>=0.20,<0.23` (dropped docutils 0.19, added docutils 0.22) - **markdown-it-py**: `~=4.0` (upgraded from v3)  ## ⬆️ Dependency Upgrades |
| `v5.0.0` | 2026-01-15 | Low | # MyST-Parser 5.0.0  **Release Date**: 2026-01-15  This release significantly bumps the supported versions of core dependencies:  ## ‼️ Breaking Changes  This release updates the minimum supported versions:  - **Python**: `>=3.11` (dropped Python 3.10, tests up to 3.14) - **Sphinx**: `>=8,<10` (dropped Sphinx 7, added Sphinx 9) - **Docutils**: `>=0.20,<0.23` (dropped docutils 0.19, added docutils 0.22) - **markdown-it-py**: `~=4.0` (upgraded from v3)  ## ⬆️ Dependency Upgrades |
| `v5.0.0` | 2026-01-15 | Low | # MyST-Parser 5.0.0  **Release Date**: 2026-01-15  This release significantly bumps the supported versions of core dependencies:  ## ‼️ Breaking Changes  This release updates the minimum supported versions:  - **Python**: `>=3.11` (dropped Python 3.10, tests up to 3.14) - **Sphinx**: `>=8,<10` (dropped Sphinx 7, added Sphinx 9) - **Docutils**: `>=0.20,<0.23` (dropped docutils 0.19, added docutils 0.22) - **markdown-it-py**: `~=4.0` (upgraded from v3)  ## ⬆️ Dependency Upgrades |
| `v5.0.0` | 2026-01-15 | Low | # MyST-Parser 5.0.0  **Release Date**: 2026-01-15  This release significantly bumps the supported versions of core dependencies:  ## ‼️ Breaking Changes  This release updates the minimum supported versions:  - **Python**: `>=3.11` (dropped Python 3.10, tests up to 3.14) - **Sphinx**: `>=8,<10` (dropped Sphinx 7, added Sphinx 9) - **Docutils**: `>=0.20,<0.23` (dropped docutils 0.19, added docutils 0.22) - **markdown-it-py**: `~=4.0` (upgraded from v3)  ## ⬆️ Dependency Upgrades |
| `v5.0.0` | 2026-01-15 | Low | # MyST-Parser 5.0.0  **Release Date**: 2026-01-15  This release significantly bumps the supported versions of core dependencies:  ## ‼️ Breaking Changes  This release updates the minimum supported versions:  - **Python**: `>=3.11` (dropped Python 3.10, tests up to 3.14) - **Sphinx**: `>=8,<10` (dropped Sphinx 7, added Sphinx 9) - **Docutils**: `>=0.20,<0.23` (dropped docutils 0.19, added docutils 0.22) - **markdown-it-py**: `~=4.0` (upgraded from v3)  ## ⬆️ Dependency Upgrades |
| `v5.0.0` | 2026-01-15 | Low | # MyST-Parser 5.0.0  **Release Date**: 2026-01-15  This release significantly bumps the supported versions of core dependencies:  ## ‼️ Breaking Changes  This release updates the minimum supported versions:  - **Python**: `>=3.11` (dropped Python 3.10, tests up to 3.14) - **Sphinx**: `>=8,<10` (dropped Sphinx 7, added Sphinx 9) - **Docutils**: `>=0.20,<0.23` (dropped docutils 0.19, added docutils 0.22) - **markdown-it-py**: `~=4.0` (upgraded from v3)  ## ⬆️ Dependency Upgrades |
| `v5.0.0` | 2026-01-15 | Low | # MyST-Parser 5.0.0  **Release Date**: 2026-01-15  This release significantly bumps the supported versions of core dependencies:  ## ‼️ Breaking Changes  This release updates the minimum supported versions:  - **Python**: `>=3.11` (dropped Python 3.10, tests up to 3.14) - **Sphinx**: `>=8,<10` (dropped Sphinx 7, added Sphinx 9) - **Docutils**: `>=0.20,<0.23` (dropped docutils 0.19, added docutils 0.22) - **markdown-it-py**: `~=4.0` (upgraded from v3)  ## ⬆️ Dependency Upgrades |
| `v5.0.0` | 2026-01-15 | Low | # MyST-Parser 5.0.0  **Release Date**: 2026-01-15  This release significantly bumps the supported versions of core dependencies:  ## ‼️ Breaking Changes  This release updates the minimum supported versions:  - **Python**: `>=3.11` (dropped Python 3.10, tests up to 3.14) - **Sphinx**: `>=8,<10` (dropped Sphinx 7, added Sphinx 9) - **Docutils**: `>=0.20,<0.23` (dropped docutils 0.19, added docutils 0.22) - **markdown-it-py**: `~=4.0` (upgraded from v3)  ## ⬆️ Dependency Upgrades |

## Citation

- HTML: https://www.freshcrate.ai/projects/myst-parser
- Markdown: https://www.freshcrate.ai/projects/myst-parser.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/myst-parser/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._