unstale

pypi / myst-parser

myst-parser

What changed in myst-parser 5, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-21.

4 breaking3 behavior and defaults3 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.1 on npm

myst-parser 510 changes

Breaking changes 4

  • Requires docutils >=0.20,<0.23, dropping 0.19 and allowing 0.22.

    5.0.0release notes

  • Updates the required markdown-it-py version to ~=4.0 from v3.

    5.0.0release notes

  • Requires Python >=3.11, dropping Python 3.10, and adds support for Python 3.14.

    5.0.0release notes

  • Requires Sphinx >=8,<10, dropping Sphinx 7 and adding Sphinx 9 support.

    5.0.0release notes

Behavior and default changes 3

  • The mode now includes GFM autolinks and alerts, with improved strikethrough and tasklist handling.

    5.1.0release notes

  • Warnings now use the docname instead of the source path in their locations.

    5.1.0release notes

  • Improves generation of meta nodes.

    5.0.0release notes

Fixes and other changes 3

  • Parsing now stops at colon fences, fixing nested colon fence directives.

    5.1.0release notes

  • Ampersands in Markdown URLs are correctly encoded by not HTML-escaping refuri.

    5.1.0release notes

  • Improves MathJax 4 compatibility for Sphinx 9.

    5.1.0release notes