写博客、做文档站、搭笔记工具，只要涉及到让用户输入内容再显示出来，八成会用到 Markdown。它比 HTML 好写，比富文本干净，但浏览器并不认识它，得靠解析库把 Markdown 文本转成网页能显示的 HTML。这次整理了 4 款开源免费、可商用的 Markdown 解析渲染库，从轻量到全能都有，按自己的场景挑一个装进项目里就能用。
四款库的定位差别
marked 主打快和轻，一个文件不到 50KB，只做 Markdown 转 HTML 这一件事，写法简单，适合不需要花哨功能的场景。markdown-it 是生态最好的一款，官方和社区的插件非常多，表格、任务列表、脚注、数学公式这些扩展语法都有人做好了，做文档站基本都选它。showdown 的特别之处是双向转换，既能 Markdown 转 HTML，也能把现成的 HTML 转回 Markdown，做内容迁移和格式互转的时候很有用。remarkable 配置项清晰，输出节奏快，适合想自己控制解析细节的人。
实际怎么接入
这四个库都是单文件，引入方式很简单，页面里加一行 script 标签，或者用包管理器装一下都行。用法就两步，把 Markdown 文本丢进库的方法里，拿到返回的 HTML 塞进页面容器。有一点要特别注意，marked 这类库默认不做 XSS 防护，如果渲染的是用户提交的内容，一定要配合 DOMPurify 之类的过滤库，不然会有安全风险。只是渲染自己写的内容，就没这个问题。
该挑哪一个
选择其实不难。追求简单快速、功能够用就好，选 marked。需要表格、公式、流程图这类扩展语法，选 markdown-it，它的插件生态能省掉你大量开发时间。有 HTML 和 Markdown 互相转换的需求，选 showdown。想精细控制解析过程、或者对输出有特殊要求，选 remarkable。这几个库互不冲突，也可以按项目混着用。
授权与包内容
四款库全部是 MIT 协议，可以免费商用、修改、再分发，保留 LICENSE 文件即可，没有任何附加限制，用在自己项目里、给客户交付、甚至打包进产品对外卖都没问题。压缩包里每个库单独一个目录，放的是压缩好的正式文件，直接引到页面就能跑，配套的说明文档里写了基础用法和常用配置。整包体积很小，几个文件加起来才几百 KB，对项目几乎不增加负担。
Markdown 解析属于看起来很基础、真自己写起来又很烦的一类需求，边界情况特别多，表格、嵌套列表、代码块、转义字符，随便一个都能卡住半天。用现成的成熟库，能少走很多弯路，也省得为这些细节反复调试。这包已经按用途分好类，你按自己的场景挑一个就行，不必全用上。后面还会继续整理前端开发常用的库合集，需要的可以关注一下，有想找的类型也可以留言说。
暂无评论内容