Markdown 渲染引擎怎么选：marked、markdown-it 和 Markdig 对比

做 Markdown 渲染时，很多人会在 marked、markdown-it 和 Markdig 之间犹豫。它们都能把 Markdown 转成 HTML，但所属生态、扩展能力和适合场景并不一样。

先给结论：

• 前端或 Node.js 项目，优先选 markdown-it
• 只想快速把 Markdown 转成 HTML，可以选 marked
• .NET 或 C# 项目，优先选 Markdig

如果不考虑语言限制，只看现代通用性和可扩展性，markdown-it 是三者里最均衡的选择。

marked：轻量快速

marked 的特点是简单、轻量、上手快。它的 API 很直接，适合快速把 Markdown 渲染成 HTML。

优点

• 速度快，适合简单渲染
• API 简单，接入成本低
• 代码量少，容易嵌入项目

缺点

• 可扩展性较弱
• 插件生态不如 markdown-it
• 复杂语法定制比较麻烦
• 对扩展 Markdown 语法的支持通常需要额外配置或二次处理

适合场景

• 简单博客
• 内部工具
• 快速原型
• 不需要复杂扩展语法的页面

markdown-it：最均衡

markdown-it 是 JavaScript 生态里非常成熟的 Markdown 渲染方案。它的插件机制完整，扩展能力强，适合长期维护的内容系统。

优点

• 插件生态强
• 可扩展性高
• 支持自定义语法
• 适合处理数学公式、任务列表、脚注、流程图等扩展场景
• 输出控制能力强，可以配合安全过滤和 HTML 控制

缺点

• 比 marked 稍复杂
• 极限性能通常不如 marked，但多数业务场景差异不明显

适合场景

• 文档系统
• CMS 内容系统
• 富 Markdown 编辑器
• 中大型 Web 应用
• 需要扩展语法的项目

Markdig：.NET 生态首选

Markdig 是 C# / .NET 生态里常用的 Markdown 渲染库。它是原生 .NET 实现，性能好，扩展能力也比较完整。

优点

• 适合 .NET 项目
• 支持 GitHub Flavored Markdown 较完整
• 扩展管道设计清晰
• 适合服务端渲染
• 在企业后台和 ASP.NET Core 项目中比较稳

缺点

• 只适用于 .NET 生态
• JavaScript 项目无法直接使用
• 插件生态不如 markdown-it 丰富

适合场景

• ASP.NET Core 网站
• .NET CMS 系统
• 企业后台系统
• 服务端 Markdown 渲染
• .NET 静态站点生成

核心对比

怎么选

如果你做的是前端、Node.js、文档站或 CMS，优先选 markdown-it。它的插件生态和扩展能力更适合长期维护。

如果你只需要最简单的 Markdown 转 HTML，并且不打算扩展复杂语法，marked 更轻、更直接。

如果你的项目是 ASP.NET Core、C# 后台或 .NET CMS，直接选 Markdig。它更贴合 .NET 技术栈，服务端渲染也更稳。

总结

三者没有绝对优劣，关键看项目生态和使用场景：

• marked：简单快，但不够灵活
• markdown-it：综合最均衡，适合 JavaScript 生态的多数内容系统
• Markdig：.NET 生态里的标准选择

如果你在 JavaScript 生态里犹豫，优先选 markdown-it，基本不会错。