NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #358 most downloaded on PyPI
A sane and fast Markdown parser with useful plugins and renderers
Latest stable
3.4.0
Last release 1 months ago
19 Oct 2026
Ships unpredictably
gaps range from 2 weeks to 1.3 years
Some releases are documented
notes for 23 of 42 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
57 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Keep escaped backslashes in angle-bracket link destinations - by @chuenchen309 and Claude Opus 4.8 (1M context) (e12f0)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Released on Oct 19, 2026
Add Python 3.15 support and include it in the CI test matrix.
Require Python 3.10 or later.
Parse inline links with an opening-bracket stack and replace per-syntax failure caches with source-local delimiter scanning.
Share one inline nesting budget across images, links, emphasis, and plugins. Expose InlineParser.max_nested_level; the older max_emphasis_depth and max_image_depth settings configure the same limit.
Preserve later valid syntax when a candidate fails or reaches a nesting limit, rather than treating the remaining input as unparsed text.
Enforce CommonMark's 999-character reference label limit, balanced and bounded destination parentheses, and link title constraints.
Improve performance for unclosed inline HTML, unmatched code delimiters, deeply nested images, and repeated text fragments.
Recognize inline HTML comments permitted by CommonMark 0.31.2.
Parse links containing full reference images without treating the image's reference label as a nested link.
Preserve reference definitions parsed inside multi-paragraph footnotes.
Accept definition-list markers indented by up to three spaces.
Prefer longer registered abbreviation matches over shorter prefixes.
Require at least one digit in ordered list continuation markers.
Add Markdown rendering for strikethrough, mark, and insert plugins.
Preserve escaped pipes in table code spans, literal trailing heading hashes, meaningful code span edge spaces, and leading blank lines in Markdown output.
Keep images whose alt text matches their URL from becoming autolinks.
Preserve non-line-break separator characters in rendered lists and hard line breaks in tight ReST list items.
Document per-document renderer context and correct the custom Markdown renderer example.
Preserve literal backslashes, image introducers, HTML delimiters and entity prefixes when rendering Markdown for a round trip.
Only recognize task list markers in a list item's leading paragraph, preserving literal markers in headings.
Bound the global convenience-parser cache and avoid retaining caller-owned renderers and plugin objects.
Add public HTML output helpers for raw HTML, attributes, and URL policy.
Share collision-safe default heading IDs between both TOC APIs.
Add explicit start-character hints for custom inline rules; unhinted custom rules now use the correctness-first regular-expression scanner.
Consolidate adversarial parser growth tests and document the security model.
Improve parsing for edge cases - by @lepture (53412)
Released on Jul 22, 2026
Harden inline parsing against deeply nested and adversarial link, image, emphasis, formatting, math, and reference inputs.
Improve performance for repeated link suffixes, dense emphasis, unclosed formatting markers, inline spoilers, and adjacent ruby tokens.
Refactor the inline parser into dedicated emphasis and link modules.
Escape literal */_ emphasis markers in the Markdown renderer so round-tripping escaped text does not re-introduce emphasis.
Set prev token in render_list_item and add block_text to ignore_blocks - by @gaoflow in #456 (0799e)
Released on Jul 9, 2026
Limit deeply nested emphasis and image parsing to avoid RecursionError.
Fix repeated link suffix and unclosed formatting marker performance issues.
Fix unclosed inline spoiler performance issues.
Avoid recursive parsing for adjacent ruby tokens.
Speed up footnote reference indexing.
Try to support python 3.8 - by @lepture (c9f1a)
Released on Jun 23, 2026
Fix Python 3.8 import compatibility in the inline parser.
Fix mypy compatibility for list parsing on Python 3.8 and 3.9+.
abbr : Update process_text method in abrr, adding parse_emphasis parameter - by @lepture (ae850)
Released on Jun 22, 2026
Fix abbr plugin compatibility with escaped inline text.
Normalize included Markdown line endings before parsing directives.
Resolve O(n^2) DoS in parse_link_text (CWE-400) - by bhanugoudm041 (b6b49)
Released on Jun 21, 2026
Improve CommonMark compatibility and parser performance.
Add command line entrypoint with UTF-8 output.
Support display and backtick math.
Render plugin list and table nodes in Markdown renderer.
Escape leading block markers in Markdown renderer.
Fix RST renderer for block quotes nested in lists.
Avoid generated heading ID collisions in TOC.
Harden URL, image, figure, and include directive handling.
Fix quadratic scans in inline links, reference links, and formatting markers.
Fix math escaping, currency pattern matching, and cross-line matching.
Resolve Windows compatibility issues in file inclusion and tests - by @Yuki9814 (25471)
Released on May 3, 2026
Escape link in render_toc_ul.
Escape text in math plugin.
Fix regex for math plugin.
Escape heading's ID attribute.
Fix LINK_TITLE_RE to prevent DoS.
Escape class attribute for admonition directive.
Remove double-encoding of image alt text.
Escape class attribute for image directive.
Fix width/height attribute for image directive.
Support footnotes that start on the next line. - by @kylechui (2677e)
Released on Dec 23, 2025
Announce supports for python 3.14
Fix footnotes plugins for code blocks, ref links, blockquote and etc.
Fix ref links in TOC.
Add fenced directive break rule in list parser, #412 - by @lepture in #412 (ea3ec)
Released on Aug 29, 2025
Add fenced directive break rule in list parser.
Prevent removing unicode whitespace when parsing atx heading.
Announce supports for python 3.12 and 3.13 - by @lepture (ff831)
Released on Mar 19, 2025
Announce supports for python 3.12 and 3.13
plugin: Fix footnote plugins when rendering ast - by @lepture (a7289)
Released on Feb 19, 2025
Fix footnotes plugin for AST renderer
Change attribute name from markdown to md in the Plugin class - by @impocode (f86ad)
Released on Jan 28, 2025
Fix render_toc_ul method for empty iterable
Fix ruby plugin's regex pattern and HTML rendering
Add typing-extensions into dependencies - by @lepture (93fd1)
Released on Dec 30, 2024
Fix only HTML-escape URLs when rendering to HTML
Add block_quote prefix on empty lines too
Fix RecursionError for lists - by @lepture (44cc6)
Released on Sep 30, 2023
Fix list parser to avoid RecursionError
Add py.typed for mypy - by @lepture (777db)
Released on Jun 10, 2023
Add py.typed for mypy
Add tests, docs for sdist
Support renderer="ast" for rendering AST
Add more type hints - by @lepture (26a69)
Released on Jun 08, 2023
Do not strip leading unicode spaces like emsp
Ensure new line at end of the text
Fix empty list renderer - by @gholker (8a66f)
Released on Mar 22, 2023
Fix fenced directives
Fix inline link parser
Fix block math plugin for multiple lines
Fix empty list item for markdown renderer
Fix plugin footnotes when there is no newline at the end
Released on Nov 30, 2022
Fix plugin footnotes when there is no newline at the end
Move safe HTML entities to HTMLRenderer
Redesign directives parsing
Add Image and Figure directive
Breaking change, rename RstDirective to RSTDirective
Released on Nov 25, 2022
Render inline math with \( and \)
Added RSTRenderer, and MarkdownRenderer
Fix toc_hook method
Breaking change, rename RstDirective to RSTDirective
Breaking change on directive design, added fenced directive
Released on Nov 6, 2022
Add spoiler plugin
Add collapse option for TableOfContents directive
Breaking change on directive design, added fenced directive
Released on Sep 26, 2022 * Add superscript plugin
Released on Sep 26, 2022
Add superscript plugin
Change toc parameter depth to level
Released on Jul 14, 2022
Fix ruby plugin
Change toc parameter depth to level
Escape block code in HTMLRenderer
Released on Jul 13, 2022
Escape block code in HTMLRenderer
Fix parsing links
This is the first release of v3. Features included:
Released on Jul 12, 2022
This is the first release of v3. Features included:
redesigned mistune
plugins
directives
Fix overzealous html unescaping - by @dairiki in #448 (7e749)
Improve on parsing list. Make it possible to customize list regex. ref https://github.com/lepture/mistune/issues/331
Improve on parsing list. Make it possible to customize list regex. ref https://github.com/lepture/mistune/issues/331
* Fix url plugin in tag * Fix * formatting
url plugin in <a> tag* formattingSecurity fix for CVE-2022-34749
Fix escape_url via https://github.com/lepture/mistune/pull/295
Fix escape_url via https://github.com/lepture/mistune/pull/295
Fix XSS for image link syntax.
Fix XSS for image link syntax.
Nothing published for this version
In this release, we have a Security Fix for harmful links.
In this release, we have a Security Fix for harmful links.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This is the first release of v2. An alpha version for users to have a preview of the new mistune.
This is the first release of v2. An alpha version for users to have a preview of the new mistune.
Support an escaped pipe char in a table cell. #150
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.