Archify、Mermaid、Excalidraw、PlantUML 怎么选?
先说结论: 只需在 Markdown 里嵌几行小图,选 Mermaid;一群人需要同屏自由拖框头脑风暴,选 Excalidraw;团队已有 CI 纯文本 DSL 流水线,选 PlantUML 或 D2。而当你想零画图语法门槛、快速把任何复杂的事讲清楚——不管是软件架构、科普原理、工作复盘,还是旅游攻略、租房避坑、理财/年假规划——想交给 Coding Agent 直接产出一份不穿模、高颜值、可交互的单文件 HTML(10 种原生图型),或者结论先行、图文联动、内置 4 套排版风格的一页式解答(Explainer),选 Archify。
不限于代码:把万物变成可互动的高颜值网页作品
Archify 是 archify.si 上的开源 Agent Skill(Apache-2.0),源码位于 github.com/tt-a1i/archify。使用它完全不需要先有代码仓库,也不用背画图语法:你只需要像平时聊天一样说出想法,或者把已有草稿、Mermaid 文本、仓库路径交给 Agent。
Agent 会在极短时间内帮你选定最贴合问题的结构——覆盖十种原生图型(architecture 架构图、workflow 工作流、sequence 时序图、dataflow 数据流、lifecycle 状态生命周期、erd 实体关系、class 类图、tree 树图、timeline 时间线、waterfall 瀑布图),或编写 .archify.md 生成一页式解答(Explainer)——再经本地确定性布局、防穿模路由与校验门禁(原生图表默认执行真实浏览器检查;一页式解答默认执行结构与交付校验,传入 --browser-check 时按需开启浏览器检查),交付一个双击即可离线打开、还能让 Agent 继续二次扩展的精致 HTML 成品。
正因如此,Archify 和“纯文本画图渲染器”或“空白画板”并非简单替代关系:它既能帮你读懂真实代码仓(如 MCO 运行时案例),也能几句话做出上海四天 CityWalk 互动行程和大城市首次租房避坑指南。如果你的诉求仅仅是在 README 里塞三四个方框,直接写 Mermaid 依然最轻省。
一张表看差异
| 对比维度 | Archify | Mermaid | Excalidraw | PlantUML / D2 |
|---|---|---|---|---|
| 创作门槛与速度 | Agent 自然语言快速直出 | 需手写并调试语法 | 需鼠标手工画框对齐 | 需手写较重 DSL |
| 覆盖题材范围 | 生活/科普/规划/代码均可 | 文档内嵌小流程 | 白板手绘头脑风暴 | 偏工程与 UML 建模 |
| 图型与表达形式 | 10 种图型 + 4 风格 Explainer | 常规语法图 | 自由画布 | 丰富 UML / 架构图 |
| 排版美感与防乱 | 确定性路由+浏览器检查+双主题 | 节点多易连线交叉 | 取决于手工排版 | 自动静态排版 |
| 阅读交互体验 | 聚焦/链路高亮/图文同步亮/导出 | 多为静态 SVG | 导出后为静态图 | 多为静态图 |
| 一页式解答能力 | 结论+图+表+步骤+溯源并排 | 不支持 | 不支持 | 不支持 |
| 交付与扩展性 | 独立 HTML,可对话继续加功能 | 依赖宿主 Markdown | 云端/画布文件 | 依赖渲染服务 |
| 最适合的场景 | 高颜值快速讲透复杂万物 | GitHub 小型示意图 | 多人实时涂鸦讨论 | 纯文本 CI 版本流 |
这张表对比的是默认定位与强项。熟练作者同样可以把 Mermaid 写得很干净,几分钟的 Excalidraw 草图也常比正式图表更适合即时对齐——选型只需围绕读者的使用方式。
什么时候不该选 Archify
- 选 Mermaid:图只有十几步、必须直接嵌入 GitHub / 博客 Markdown 代码块,且需要人手随时改几行文本。
- 选 Excalidraw:价值在于多人同屏实时手绘、随便拖放图形并保留轻松的草图感。
- 选 PlantUML 或 D2:团队已将纯文本图表接入 CI 流水线,追求文本行级 diff 或高密度形式化 UML 记号。
- 选 BI 或可观测性工具:需要监控实时在线指标、告警大盘或实时链路采样;Archify 交付的是创作好的静态 HTML 成品,而非监控后端。
- 选云端托管协作平台:需要账号权限体系与多人同时编辑同一张云端画布;Archify 主打本地、免登录、无依赖交付。
同时,Archify 也不承诺无损解析全部 Mermaid 高级语法、无需引导就自动看懂任意超大型仓库,或仅靠结构校验替现实业务的真实性背书——工具保证排版干净与渲染可信,事实把关仍属于创作者。
四个高频实战场景
1. 不限于代码:把生活规划、旅行攻略或复杂决策一页讲透
不需要仓库也能用:看看一年年假怎么排流程图、租房看房议价时序图、月薪现金流去向图、求职投递状态机,以及大城市首次租房签合同避坑 Explainer。更特别的是,因为成品本身就是干净独立的 HTML,社区用户甚至在生成上海四天 CityWalk 行程图后继续让 Agent 加上高德/小红书跳转、抵达打卡与停留记录。你可以直接在工作流快速开始用一句话试画。
2. 把越画越乱的 Mermaid 草稿快速“挽救成成品”
如果手头的 Mermaid 已经节点密密麻麻、连线四处穿模,直接把源码贴给配置好的 Agent,让它用 Archify 重新理清逻辑并产出带聚焦和高亮追踪的 HTML。详见 Mermaid 输入指南。注意这不是无损转换:Agent 会理解图中的真实关系并重写出干净的 JSON,而不会机械保留原草稿里的样式指令或前端回调。
3. 一张图讲不完的问题:用 Explainer 图文联动一页讲透
科普原理解析、故障复盘、业务方案评审或深度教程,往往既要结论又要图和步骤对照。Archify 的 .archify.md 一页式解答会先给出明确结论与理由,再分成面板将文字、表格、步骤与已校验示意图左右并排——读到哪一步,图上就自动高亮哪一部分,支持 4 套高颜值排版风格、深浅主题、长图/PDF 导出及单面板追问。点击体验真实成品:P99 尾延迟暴涨一页式解答与首次访问 HTTPS 发生了什么。
4. 需要源码依据时:梳理真实代码仓库不靠猜
落回软件工程场景时,可以让 Agent 沿固定 Git 提交读取真实代码片段并挂载文件依据,避免模型“幻觉画框”。见 MCO 运行时案例、MCO 交互架构成品与仓库证据清单。
选 Archify 之前先确认
- 手边是否有支持读写文件与 Node.js 的 Coding Agent(如 Claude Code、Codex、Cursor、OpenCode 或 GitHub Copilot)?
- 你是否希望跳过繁琐的画图语法和手工对齐,直接获得十种原生图型或四种风格的图文联动 Explainer?
- 你的读者是否需要点击聚焦、深浅色切换、高清导出(PNG / SVG / WebP / WebM / PDF)或可继续扩展的 HTML 交付物?
- 当场景不需要死守 Markdown 代码块内嵌、而是可以交付一个双击即开的独立 HTML 时,Archify 的体验与说服力优势最明显。
如果只是在文档里随手放三五个框,Mermaid 依然最顺手;一旦你想用高颜值、快节奏、强交互把任何复杂想法、生活攻略或技术系统一眼讲透,建议从场景指南、Agent 画图指南或快速上手安装页开始尝试。