mistune
A sane and fast Markdown parser with useful plugins and renderers
Decision gist · record as of 2026-08-14
Yes. Mistune is a mature, actively maintained parser with low install friction, no known vulnerabilities, permissive licensing, and broad Python version support. It's well-suited for any project that needs to convert Markdown to HTML, whether as a core feature or a utility component.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low install friction with a single pure-Python dependency (typing-extensions).
- Active maintenance with a release 23 days ago.
License · maintenance · safety
BSD-3-Clause (permissive) — BSD-3-Clause is permissive; you can use, modify, and distribute mistune freely in commercial and private projects with minimal restrictions.
last release 2026-07-22 (23 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 80,266,122 downloads/mo, #421 on PyPI
Alternatives
Verify before relying
pip install mistune
import mistune
html_output = mistune.html(your_markdown_text)- Whether the plugin system and renderer customization are documented with examples in the published docs.
- Performance characteristics compared to other Markdown parsers for large documents.
What it is and what it does
Mistune is a Markdown parser that converts Markdown text to HTML. It's designed to be both fast and feature-rich, with support for custom renderers and plugins to extend its behavior. The core dependency is typing-extensions, making it lightweight and straightforward to install.
You use mistune by importing it and calling mistune.html() on your Markdown string. It supports modern Python versions (3.8 through 3.14) on both CPython and PyPy. The package has been actively maintained since 2014 and is currently in Beta status, indicating it's stable for production use but may still evolve.
Use it for
- Convert user-generated Markdown content to HTML in web applications or APIs.
- Build static site generators that process Markdown files into HTML pages.
- Parse Markdown documentation and render it for display in tools or dashboards.
- Extend Markdown parsing with custom renderers for domain-specific output formats.
- Process Markdown in batch workflows where performance matters.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
Mistune is a mature, actively maintained parser with low install friction, no known vulnerabilities, permissive licensing, and broad Python version support. It's well-suited for any project that needs to convert Markdown to HTML, whether as a core feature or a utility component.
Install
mistune on PyPI
Before you install
Low install friction with a single pure-Python dependency (typing-extensions). Active maintenance with a release 23 days ago.
License in practice
BSD-3-Clause is permissive; you can use, modify, and distribute mistune freely in commercial and private projects with minimal restrictions.
Quickstart
pip install mistune
import mistune
html_output = mistune.html(your_markdown_text)Verify before relying
- Whether the plugin system and renderer customization are documented with examples in the published docs.
- Performance characteristics compared to other Markdown parsers for large documents.
Package facts
| License | BSD-3-Clause permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagetyping-extensions |
| Maintenance | Actively maintained 23 days since the last release |
| First released | |
| Downloads | 80,266,122 / month, #421 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: ConsoleEnvironment :: Web EnvironmentIntended Audience :: DevelopersLicense :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Text Processing :: Markup |
Evidence: mistune-3.3.4-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 › “fast markdown parsing”
- mistuneMistune converts Markdown text to HTML using a fast parser with…
- comrakRenders CommonMark and GitHub Flavored Markdown to HTML or normalized…
- pyromarkpyromark is a CommonMark-compliant Markdown parser that converts…
Give your agent the search over MCP, or paste the wish link into any chat.
More Markup packages
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.
A Python markdown parser that converts markdown to HTML following the CommonMark specification, with support for plugins and custom syntax rules.
Install it if you need reliable markdown-to-HTML conversion.
Beautiful Soup parses HTML and XML documents into a navigable tree, providing Pythonic methods to search, iterate, and modify the parsed content.
Install it if you need to parse or extract data from markup documents.
et_xmlfile writes large XML files with minimal memory overhead by serializing elements to disk as they are created, rather than holding the entire tree in memory.
Install it if incremental XML writing fits your use case; skip it if your XML documents are small or you already use lxml.
Parses and edits TOML files while preserving formatting, comments, and structure, then serializes them back with layout intact.
Install it if you're building tools that touch TOML files and user readability of the source matters.
Parses Python docstrings in ReST, Google, Numpydoc, and Epydoc formats, extracting structured information like descriptions, parameters, return types, and exceptions.
Install it if you need to programmatically read and extract structured data from Python docstrings.
See also mistletoe · marko · textile · Markdown · pyromark · html-to-markdown · markdown-pdf · markdown2 · mdit-plain · markdown-it-pyrs