mistune

A sane and fast Markdown parser with useful plugins and renderers

mistune Permissive license BSD-3-Clause Active v3.3.4 released 2026-07-22

Install

mistune on PyPI

pip

pip install mistune

uv

uv add mistune

poetry

poetry add mistune

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 — typing-extensions
Maintenance	actively maintained — 22 days since the last release
First released	2014-02-26
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: mistune-3.3.4-py3-none-any.whl

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

About mistune

from the package's own PyPI description — quoted content, verbatim

Mistune v3

A fast yet powerful Python Markdown parser with renderers and plugins.

Overview

Convert Markdown to HTML with ease:

.. code-block:: python

import mistune
mistune.html(your_markdown_text)

Useful Links

GitHub: https://github.com/lepture/mistune
Docs: https://mistune.lepture.com/

License

Mistune is licensed under BSD. Please see LICENSE for licensing details.

Read as markdown · JSON record · Source repository · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Mistune is a fast Markdown parser that converts Markdown text to HTML, with support for renderers and plugins for customization.

Low install friction with a pure Python wheel distribution and only one lightweight runtime dependency (typing-extensions). Active maintenance with a release 22 days ago signals ongoing support.

BSD-3-Clause is a permissive license allowing commercial and private use with minimal restrictions, requiring only preservation of copyright and license notices.

Usage

import mistune
html_output = mistune.html('# Hello World')

Requires Python 3.8 or later

Verdict: Mistune is a well-maintained, lightweight Markdown parser with low install friction, broad Python version support (3.8–3.14), and no known security vulnerabilities. Its permissive BSD license and top-1000 PyPI popularity make it a reliable choice for Markdown-to-HTML conversion.

Needs verification

Whether the plugin and renderer customization capabilities meet your specific formatting or extension requirements
Performance characteristics compared to alternative Markdown parsers for your typical document sizes

markdown to html parserpython markdown converterfast markdown renderermarkdown parsing librarymarkdown html generationlightweight markdown processor