markdown-it-py

4.0.0 · active · verified Sat Mar 28

markdown-it-py is a Python port of the popular markdown-it library, providing fast and extensible Markdown parsing with full CommonMark compliance. The current version is 4.0.0, released in August 2025, with a release cadence of approximately one major version per year.

Warnings

breaking Dropped support for Python 3.8 and 3.9 in version 4.0.0.
Fix: Upgrade your Python environment to version 3.10 or later.
breaking Updated parser to comply with CommonMark 0.31.2 and Markdown-It v14.1.0, which may affect parsing behavior.
Fix: Review your Markdown content to ensure compatibility with the updated parsing rules.
deprecated The use of StateBase.srcCharCode is deprecated; replaced by StateBase.src.
Fix: Update your code to use StateBase.src instead of StateBase.srcCharCode.
gotcha The linkify feature requires the optional linkify-it-py dependency.
Fix: Install the optional dependency using pip install markdown-it-py[linkify].

Install

pip install markdown-it-py Install markdown-it-py

Imports

MarkdownIt
```
from markdown_it import MarkdownIt
```
The correct import is from the markdown_it module, not markdown_it_py.

Quickstart

This example demonstrates how to convert a Markdown string to HTML using markdown-it-py.

from markdown_it import MarkdownIt

md = MarkdownIt()
text = "# Hello World\n\nThis is a paragraph with **bold** and *italic* text."
html = md.render(text)
print(html)

view raw JSON →