夜雨聆风学习资料网

ARTICLE · 1388480

文档里的流程图总是糊的?9.1万Star开源:几行字就能生成可改的图(附收藏表)

文档里的流程图总是糊的?9.1万Star开源:几行字就能生成可改的图(附收藏表)

文档里的流程图总是糊的?9.1万Star开源:几行字就能生成可改的图(附收藏表)

方案、周报、说明文档里,经常要配一张流程图。最常见的做法,是在画图工具里拖方块,截一张图贴进去。

这样做有两个难受的地方。一是图容易糊,放大、转存、再压缩一次,箭头和字就看不清了。二是流程稍一改,就得重画、重截、重贴。文档还在,图已经是上一版。不是不会画,是图和文字各管各的,改起来不同步。

后来我在 GitHub 上翻到一个开源项目,叫 Mermaid。今天(2026-11-10)我去仓库看了一眼,星标大约 9.1 万(91057)。仓库全名是 mermaid-js/mermaid,2014 年 11 月 1 日创建,用 TypeScript 写,协议是 MIT。作者是 Knut Sveidqvist。

它不是再做一个靠鼠标拖拽的画板。官方自己的定位是:用类似 Markdown 的文本,生成和修改各类图表。改流程就是改那几行字,图跟着变。官方还做了在线编辑器,打开就能预览。GitHub 等环境也支持在 Markdown 里直接渲染这类图。

我得先把话说在前面:下面这些,是我对照官方说明和文档整理的。我自己还没把业务里的流程图完整迁过去过,所以不会讲「我用它几分钟画出了多复杂的图、文档从此再也不糊」。那种我没经历过的事,编了才更吓人。值不值得你去 Star,文末有一张对照表,官方自己划的边界我也写进去了。

几行字怎么变成一张能改的图

它的用法很直接:先写一段描述图的文本,再交给 Mermaid 渲染成图。流程图、时序图、甘特图、类图,官方介绍里都有;还有一些类型被标成实验性,用之前要看文档,别默认全部都一样成熟。

举一个官方风格的流程图例子,你改文字,图就会改:

flowchart TD          A[收到需求] --> B[评估工作量]          B --> C{能否本周完成}          C -->|能| D[排进本周计划]          C -->|不能| E[说明原因和替代方案]

不一定要先在自己的项目里装库。官方 README 把在线编辑器作为直接入口,今天写的地址是 https://mermaid.ai/live/ 。在编辑器里左侧写文本、右侧看图,合适了再导出或把代码贴回文档。如果你把图写在 Markdown 里,GitHub 一类支持 Mermaid 的地方也可以直接显示。

要在自己的网页或工具里集成,官方文档写了可以通过 npm 安装,当前文档示例用的是 12 版本,并提到部署库本身需要 Node.js v22.12.0 或更高。这是给要集成的人看的,只想在在线编辑器里画一张图,不必先装这些。

有两件事要单独说清。第一,在线编辑器是网页,图的源码会在这个页面里处理;涉及内部流程、还不能外传的信息,不要随手贴到公共编辑器上,可以在自己的文档环境里写和渲染。第二,官方文档专门写了安全问题:如果把来路不明的 Mermaid 文本直接拿去渲染,有被夹带脚本的风险。自己写自己的图没问题,不要随便渲染别人丢过来的一段图代码。

截一张死图,和留一段能改的文本

差别其实就卡在:流程变了,你是重画一张图,还是改几行字。

截图贴进文档,发出去可能已经偏糊,过两天流程一改,文档和示意图就对不上了。用白板手绘很适合现场讨论,但要放进正式文档、还要反复改版本,源文件和贴图也容易各管各的。

这个项目盯住的是:图的真相在文本里。改「能否本周完成」后面的分支,就是改那一行字。文档、代码仓库、说明页里都能放同一段描述,图跟着更新。现场讨论仍可以用手绘白板,定稿再把关键流程写成这段文本,两种用法并不打架。

我没自己维护过一份长期更新的业务图,所以不会跟你说哪种图最好看、语法好不好记。官方文档和在线编辑器在,想感受真实样子,得自己打开试。

值不值得Star,适合谁

我把官方说明压成一张对照表,收藏比我在这儿念更有用。

适合去试的,我琢磨着是这种人:方案、周报、说明文档里经常要放流程图、时序图或计划类的甘特图,而且这些图会改。能接受花一点时间学语法,用文本而不是纯拖拽。愿意把内部流程图放在自己的文档环境里渲染,而不是随手贴进公共网页。

不适合的那些,不是我泼冷水,是它本来就有边界:

它不是手绘白板,也不适合一上来就追求像素级设计稿。要学一套语法,复杂图会有学习成本。部分图类型官方标了实验性。在线编辑器是网页,敏感内容不要随便贴。把来路不明的图代码直接拿去渲染,官方也提醒了安全风险。我自己也还没把业务图完整迁过去,不能替你打包票。

想看一眼,从哪进

想先看一眼,不必先装环境。打开官方在线编辑器,写一段上面那样的文本,就能看到图。

• 仓库:https://github.com/mermaid-js/mermaid

• 在线编辑器(官方 README 入口):https://mermaid.ai/live/

• 文档:https://mermaid.js.org/ 以及 https://mermaid.ai/open-source/

我要是自己上手,大概会先用一段不涉密的流程在在线编辑器里试试,再决定要不要写进自己的文档。语法要学、敏感内容别贴公共页面、有的图类型还是实验性——这几句官方都写明白了,或不难从文档里看出来,我不想帮它瞒着。

最后

文档里的流程图最容易糊,也最容易过时,往往是因为它是一张死图,改起来就要重画。这个开源项目盯住的,就是用几行字生成图,改字就改图。

值不值得你点一颗星,对照表自己看。我没替你把业务图全部迁过去,也不保证你写完就人人一眼能懂。官方自己都把图类型、在线编辑器和安全注意写在文档里了。

投票:你会为用文字生成流程图 Star 这类项目吗?A会 B先观望 C已经在用

评论区回个字母就行。

回复「开源作图」,领取收藏对照表:使用步骤、适合谁和不适合谁、常用图类型、官方链接,一张图存下来就能翻。平时要做开源白板、开源PDF、开源笔记、会后纪要、开源简历的,回复对应关键词也能领。

关注「路途进行时」,每天一篇打工人能照做的 AI 办公小教程。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料