跳至主要内容

与上游对比

本页将仓库中的插件与其参考（或对应的）上游 markdown-it-* 包进行对比：渲染输出的正确性、吞吐量与复杂度缩放、以及包体积。所有数据均来自仓库提交的对比运行结果；选择一个包即可查看该包的详细基准测试、复杂度缩放、参考包错误与差异。

包

26

31 个变体

正确性

720 个用例

493 完全一致45 归一化一致36 参考包错误28 差异

我们的测试套件

961 / 1208通过

247 失败264 功能缺失

另有 92 个内部实现测试跳过另有 3 个打包相关测试跳过

基准测试

186 个基准用例

normal + heavy 语料 · 小 / 中 / 大 三种规模

测量

2026-11-03

Node v26.13.0

Apple M4 · 16 GB · darwin/arm64

显示 26 / 26 个包
包正确性与测试吞吐量
@mdit/plugin-abbrmarkdown-it-abbr@2.0.022/22对比19/2223/23 完全一致1.02×979 B对比1.6 kB
@mdit/plugin-alertmarkdown-it-github-alerts@1.0.123/23对比8/234/25 完全一致4 参考包错误4 差异7 功能缺失1.00×1.4 kB对比1.9 kB
@mdit/plugin-anchormarkdown-it-anchor@10.0.04 个变体88/88对比70/8875/88 完全一致1 参考包错误5 差异4 功能缺失1.71×2.2 kB对比2.2 kB
@mdit/plugin-attrsmarkdown-it-attrs@5.0.1616/616对比610/61619/20 完全一致1 差异20 功能缺失1.03×4.6 kB对比2.6 kB
@mdit/plugin-cjk-breaksmarkdown-it-cjk-breaks@2.0.110/10对比10/1022/22 完全一致1.02×673 B对比921 B
@mdit/plugin-cjk-friendlymarkdown-it-cjk-friendly@3.0.019/19对比19/1922/22 完全一致1.00×797 B对比1.2 kB
@mdit/plugin-containermarkdown-it-container@4.0.032/32对比27/3220/23 完全一致1 差异4 功能缺失1.00×1.1 kB对比1.4 kB
@mdit/plugin-dlmarkdown-it-deflist@4.0.014/14对比11/143/22 完全一致1 参考包错误1 功能缺失1.00×978 B对比1.9 kB
@mdit/plugin-emojimarkdown-it-emoji@3.1.03 个变体54/54对比49/5467/75 完全一致3 参考包错误1 差异2 功能缺失1.02×17.8 kB对比19.0 kB
@mdit/plugin-figuremarkdown-it-image-figures@2.1.112/12对比5/1218/21 完全一致1 参考包错误1 差异27 功能缺失1.00×1.1 kB对比972 B
@mdit/plugin-footnotemarkdown-it-footnote@4.0.025/25对比5/256/22 完全一致1 参考包错误1.06×1.7 kB对比2.7 kB
@mdit/plugin-img-sizemarkdown-it-imsize@2.0.118/18对比14/186/25 完全一致1 参考包错误3 差异10 功能缺失0.98×1.8 kB对比1.6 kB
@mdit/plugin-insmarkdown-it-ins@4.0.012/12对比12/1223/23 完全一致0.98×187 B对比1.1 kB
@mdit/plugin-katexmarkdown-it-katex@2.0.317/17对比8/1710/25 完全一致5 参考包错误2 差异4 功能缺失0.96×605 B对比2.0 kB
@mdit/plugin-katex-slimmarkdown-it-katex@2.0.317/17对比8/1710/25 完全一致5 参考包错误2 差异5 功能缺失0.96×673 B对比2.0 kB
@mdit/plugin-markmarkdown-it-mark@4.0.09/9对比9/923/23 完全一致0.99×185 B对比1.1 kB
@mdit/plugin-mathjaxmarkdown-it-mathjax3@5.2.036/36对比0/368/25 完全一致3 参考包错误1 差异38 功能缺失1.14×1.7 kB对比1.7 kB
@mdit/plugin-mathjax-slimmarkdown-it-mathjax3@5.2.036/36对比0/368/25 完全一致3 参考包错误1 差异38 功能缺失1.15×1.7 kB对比1.7 kB
@mdit/plugin-plantumlmarkdown-it-plantuml@1.4.15/5对比2/56/24 完全一致1 参考包错误1 差异6 功能缺失6.96×749 B对比1.5 kB
@mdit/plugin-rubymarkdown-it-ruby@1.1.211/11对比5/1110/21 完全一致1 差异1 功能缺失1.03×614 B对比1.9 kB
@mdit/plugin-spoilermarkdown-it-spoiler@1.1.113/13对比6/1322/22 完全一致3 功能缺失0.99×235 B对比1.7 kB
@mdit/plugin-submarkdown-it-sub@2.0.09/9对比9/924/24 完全一致0.98×156 B对比674 B
@mdit/plugin-supmarkdown-it-sup@2.0.010/10对比10/1024/24 完全一致0.98×155 B对比674 B
@mdit/plugin-tasklistmarkdown-it-task-checkbox@1.0.614/14对比0/147/21 完全一致1 参考包错误1 差异2 功能缺失1.18×731 B对比1.4 kB
@mdit/plugin-texmarkdown-it-katex@2.0.366/66对比33/6618/25 完全一致4 参考包错误1 差异92 功能缺失1.01×1.7 kB对比2.0 kB
@mdit/plugin-umlmarkdown-it-plantuml@1.4.120/20对比12/2015/25 完全一致2 参考包错误2 差异6.83×665 B对比1.5 kB
测量方法
  1. 正确性对比会用两个实现渲染同一段 Markdown，并在最小化归一化（属性顺序；仅当双方都按设计输出包裹标记和生成 id 时才归一化这些内容）后逐字节比较输出；对于未使用自定义渲染器的变体，还会比较解析后的 token 流——源码映射等 token 元数据对基于这些 token 的下游插件属于公共契约。其余每一处差异都会附带原因说明。
  2. 基准性能与复杂度缩放数据为交错采样结果的中位数，因此两侧在同一进程、相同负载下运行。语料为仓库提交的 markdown 文件：normal 是语法较稀疏的真实文档，heavy 是语法密集的文档；每种语料在三个规模下测量。
  3. 测试套件对比会把每个包的单元测试直接跑在参考实现上（用参考包替换插件入口）。参考包缺少对应功能的测试会归为功能缺失；只断言内部实现细节的测试会静默跳过、仅计入汇总；其余失败测试都代表两个包之间的行为差异。
  4. 每个正确性差异都归因到一个根因：当参考实现的输出或 token 流有误时（源码映射错误、嵌套缺失/错误、内容丢失或错位、安全问题）记为「参考包错误」；当双方只是对同一结果的表示方式不同时（等价的 token 形状、同样合法的不同输出、有意的语法或选项设计）记为「差异」。统计按根因计数，而不是按用例计数。
  5. 拟合指数基于对数坐标计算：约 1 为线性增长，约 2 为二次增长。各缩放系列针对参考实现已知的超线性路径设计。
  6. 包体积按发布到 npm 的文件计算：dist/**、README、LICENSE*、package.json，以及包 files 字段中列出的其他文件。参考包体积为已安装包目录的大小，不包含嵌套的 node_modules。
  7. 入口 gzip 为 ESM 入口 gzip 后的大小：本包为 exports 解析出的入口，参考包为 package.json 中的 module / exports.import / main 入口。

提示

对比工具链与 spec 位于 compare/。运行 pnpm run compare 刷新对比数据，pnpm run compare:sizes 刷新包体积，pnpm run compare:docs 重新生成本页数据。