搞技术文档、写 Markdown 笔记的人,大概率都吃过 Mermaid 的苦。
当初大家用它,图的就是个省事——在文档里敲上几行类似 A --> B 的文本,就能自动生成流程图、时序图或者架构图,看着挺优雅。可时间一长,大家就发现这玩意儿简直是个“性能黑洞”。
页面稍微多插入几张图,滚动起来就开始丢帧卡顿;打包前端项目的时候,光这一个渲染库就能啃掉上百兆的内存;更折腾人的是,如果你想在后端服务器里把这些文本直接批量转成图片,你甚至得在服务器后台悄悄挂一个几百兆大的 Chrome 浏览器,就为了帮它“画图”。
这种痛苦,写代码的人基本都默忍了。但 Obsidian(知名本地 Markdown 笔记软件)的创始人 Steph Ango(网名 kepano)显然是个眼里揉不得沙子的人。
他嫌原版 Mermaid 实在太臃肿、太难用,干脆带头撸起袖子,从头用纯 JavaScript 把这个工具重新写了一遍,起名叫 Pele。
而且一造出来,他就直接把这东西按开源协议扔到了网上。
彻底推翻重来,它到底改了啥?
很多人可能会好奇,Mermaid 作为一个跑了好多年的开源大山,就算想重构,能优化到哪去?
数据一亮出来,直接把技术圈的人给看懵了。
传统的 Mermaid 打包下来,体积差不多要 1.6MB 左右,在前端库里绝对算个胖子。而 Pele 把所有不必要的历史包袱全扔了,重新压缩打包完只有 230KB 左右,体积直接缩减了 80% 以上。
更绝的是依赖项。原来的版本为了干各种杂活,光是绑定的第三方依赖包就有 23 个,哪天里面某个小包出了漏洞,整个项目都得跟着受累。Pele 直接做到了零依赖(Zero-Dependency),干净得像个刚装完系统的干净电脑。
渲染速度上的差距就更夸张了。
以前在网页里加载一个复杂的流程图,浏览器往往要哼哧哼哧跑上几十毫秒,遇到图片多的页面,电脑风扇都开始转。到了 Pele 这里,渲染时间直接压到了零点几毫秒的级别。你刚敲完最后一个字符,图就已经画好了,用肉眼根本感受不到延迟。
你可能会担心:把体积砍得这么狠,功能是不是也阉割了?
完全没有。Pele 在保持极度轻量化的同时,直接对标并完全兼容了 Mermaid 12.1.0 版本的全部图表语法。以前你用老语法写的流程图、甘特图、时序图,不用改一行代码,直接丢给 Pele 就能完美画出来。
真正厉害的技术突破:终于不用开浏览器画图了
如果只是把代码体积写小、把速度写快,那还只能算是个优秀的前端优化项目。Pele 最让后端开发和运维人员拍案叫绝的突破,其实是彻底脱离了对浏览器 DOM 环境的依赖。
很多没搞过图表开发的人可能不知道,传统的流程图库之所以离不开浏览器,主要是因为“算文字宽度”这个动作。
图表里的那些节点方框,到底要画多宽、多高?排版引擎必须知道框里的文本实际占了多少像素。以往的做法,必须依赖浏览器的 DOM 节点或者 Canvas 接口才能测出来。
这就导致了一个极其令人头疼的后果:如果你想在服务器后台(比如用 Java 或者 Node.js)自动把用户提交的 Markdown 渲染成漂亮的 SVG 图片或者 PDF,你就必须在服务器上跑一个叫 Puppeteer 的无头浏览器。
为了画几张流程图,后台天天挂着个几百兆内存的 Chrome 进程,不仅极其浪费服务器资源,而且挂掉的概率还特别高。在 JVM 这种非浏览器环境里,大家以前甚至只能摊手表示“无能为力”。
而 Pele 直接从根上重新设计了文字测量机制。
在网页里跑的时候,它依然可以调用 Canvas 去测字;但在没有浏览器的服务器环境里,它内置了一套字符宽度映射表;最狠的是,它还开放了自定义测量回调。
比如在 Java 环境下跑,你只需要把 Java 原生自带的字体测量接口(像 TextLayout)作为参数传给 Pele,它就能直接借用 Java 的能力把文字宽高算得一清二楚。
这样一来,后端渲染图表直接变成了一个极其简单的同步函数调用。没有了后台浏览器进程,没有了极其沉重的内存开销,一毫秒就能直接吐出一串干净优雅的矢量 SVG 代码。
为什么 Obsidian 团队总能搞出这种神器?
经常用 Obsidian 的人应该有体会,这个软件从第一天起,卖点就是“本地优先、极速响应、极简干净”。
对他们团队来说,软件里嵌入的 Mermaid 图表拖慢了用户记笔记的体验,这本身就是不可接受的。行业里绝大多数公司的做法,是花时间去安抚用户,或者在界面上做做遮眼法。
但 Obsidian 这帮人偏偏选了最硬核、也是成本最高的一条路:既然市面上的轮子不好用,那就自己干脆造个全新的,造出来还不要钱,直接拿去喂饱整个开源社区。
对于我们普通开发者或者文档折腾玩家来说,管它背后用了什么黑科技,只要能让笔记页面滚起来不卡顿、打包体积小一大截、服务器少吃两斤内存,那就是实打实的好东西。