# What changed in myst-parser

> 10 changes in myst-parser 5 from its official release notes, upgrade guides and advisories: 4 breaking. Each one cited. Sources checked 2026-10-21. HTML: https://unstale.sh/pypi/myst-parser/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## myst-parser 5

### Breaking changes

- Requires docutils >=0.20,<0.23, dropping 0.19 and allowing 0.22. (5.0.0) — [release notes](https://github.com/executablebooks/MyST-Parser/releases/tag/v5.0.0)
- Updates the required markdown-it-py version to ~=4.0 from v3. (5.0.0) — [release notes](https://github.com/executablebooks/MyST-Parser/releases/tag/v5.0.0)
- Requires Python >=3.11, dropping Python 3.10, and adds support for Python 3.14. (5.0.0) — [release notes](https://github.com/executablebooks/MyST-Parser/releases/tag/v5.0.0)
- Requires Sphinx >=8,<10, dropping Sphinx 7 and adding Sphinx 9 support. (5.0.0) — [release notes](https://github.com/executablebooks/MyST-Parser/releases/tag/v5.0.0)

### Behavior and default changes

- The mode now includes GFM autolinks and alerts, with improved strikethrough and tasklist handling. (5.1.0) — [release notes](https://github.com/executablebooks/MyST-Parser/releases/tag/v5.1.0)
- Warnings now use the docname instead of the source path in their locations. (5.1.0) — [release notes](https://github.com/executablebooks/MyST-Parser/releases/tag/v5.1.0)
- Improves generation of meta nodes. (5.0.0) — [release notes](https://github.com/executablebooks/MyST-Parser/releases/tag/v5.0.0)

### Fixes and other changes

- Parsing now stops at colon fences, fixing nested colon fence directives. (5.1.0) — [release notes](https://github.com/executablebooks/MyST-Parser/releases/tag/v5.1.0)
- Ampersands in Markdown URLs are correctly encoded by not HTML-escaping refuri. (5.1.0) — [release notes](https://github.com/executablebooks/MyST-Parser/releases/tag/v5.1.0)
- Improves MathJax 4 compatibility for Sphinx 9. (5.1.0) — [release notes](https://github.com/executablebooks/MyST-Parser/releases/tag/v5.1.0)