index.md

markdown-it-py

Markdown parser done right.

• {fa}check,text-success mr-1 Follows the CommonMark spec for baseline parsing
• {fa}check,text-success mr-1 Configurable syntax: you can add new rules and even replace existing ones.
• {fa}check,text-success mr-1 Pluggable: Adds syntax extensions to extend the parser (see the plugin list)
• {fa}check,text-success mr-1 High speed (see our benchmarking tests)
• {fa}check,text-success mr-1 Safe by default

For a good introduction to markdown-it see the Live demo. This is a Python port of the well used markdown-it, and some of its associated plugins. The driving design philosophy of the port has been to change as little of the fundamental code structure (file names, function name, etc) as possible, just sprinkling in a little Python syntactical sugar ✨. It is very simple to write complimentary extensions for both language implementations!

References & Thanks

Big thanks to the authors of markdown-it

• Alex Kocharin github/rlidwka
• Vitaly Puzrin github/puzrin

Also John MacFarlane for his work on the CommonMark spec and reference implementations.

Related Links

• https://github.com/jgm/CommonMark - reference CommonMark implementations in C & JS, also contains latest spec & online demo.
• http://talk.commonmark.org - CommonMark forum, good place to collaborate developers' efforts.

---
maxdepth: 2
---
using
architecture
other
plugins
contributing
api/markdown_it