Mistune：快速的 Python Markdown 解析器

lepture 维护的 Mistune 是一个纯 Python 实现的 Markdown 解析库，目前在 GitHub 上获得了 3,037 个 Star。

这个项目的目标是提供一个快速且功能完备的 Markdown 解析方案，内置渲染器支持和插件扩展机制。开发者可以用它完成从 Markdown 到 HTML 的转换，也可以根据需求定制渲染逻辑。

安装

Mistune 可以通过 pip 直接安装：

pip install mistune

基础用法

调用方式非常直接，一行代码即可完成转换：

import mistune

mistune.html(your_markdown_text)

性能表现

项目的 README 中附带了详细的基准测试数据。测试覆盖了 atx 标题、setext 标题、无序列表、有序列表、引用块、代码块、段落、链接等多种 Markdown 语法元素。

在 atx 标题解析场景中，Mistune 3.0.0 耗时 13.9ms。同场景下，markdown 库耗时 48.4ms，mistletoe 耗时 25.5ms，markdown_it 耗时 42.4ms，markdown2 则达到 379.3ms。

setext 标题测试中，Mistune fast 模式仅需 8.1ms，其他库普遍在 20ms 到 30ms 区间。

无序列表是 Markdown 处理中的常见场景。Mistune slow 模式耗时 59.7ms，markdown 需要 83.8ms，markdown2 需要 175.4ms。mistletoe 和 markdown_it 分别达到 74.8ms 和 103.0ms。

有序列表测试里，Mistune 3.0.0 耗时 25.1ms，markdown 为 43.3ms，markdown2 为 75.9ms，mistletoe 为 33.6ms，markdown_it 为 40.3ms。

引用块解析的差距更为明显。Mistune fast 模式 15.4ms，markdown 为 63.0ms，而 markdown2 在这个场景下达到 702.4ms。

代码块解析中，Mistune fast 模式仅 4.0ms，markdown 为 33.8ms，markdown2 为 92.5ms，mistletoe 为 9.2ms，markdown_it 为 12.5ms。

段落解析是最耗时的场景之一。Mistune fast 模式 93.6ms，而 mistletoe 和 markdown_it 分别达到 779.3ms 和 825.5ms，差距接近一个数量级。

链接解析方面，自动链接测试中 Mistune slow 模式 3.4ms，markdown 为 23.0ms。标准链接测试中 Mistune 3.0.0 为 21.9ms，markdown 为 39.1ms。

readme 综合场景测试中，Mistune fast 模式 53.9ms，markdown 为 211.0ms，markdown2 为 533.4ms，mistletoe 为 110.1ms，markdown_it 为 248.0ms。

从整体来看，Mistune 在绝大多数测试项目中都处于领先位置，部分场景的优势达到数倍甚至数十倍。

运行模式

Mistune 提供了 slow、fast、full 三种运行模式，以及默认的标准模式。不同模式在功能和性能之间做了不同的取舍，用户可以根据实际需求选择。slow 模式偏向兼容性，fast 模式追求解析速度，full 模式启用完整功能集。

许可证与维护

Mistune 采用 BSD 许可证发布，对商业项目没有额外限制。项目由 lepture 持续维护，同时也接受社区贡献和赞助支持。

如果你在 Python 项目中需要处理 Markdown 文本，无论是简单的格式转换还是复杂的自定义渲染，Mistune 都是一个值得纳入候选名单的库。

需要处理 Markdown 文本，无论是简单的格式转换还是复杂的自定义渲染，Mistune 都是一个值得纳入候选名单的库。