把 Mermaid 流程图导出为读得懂的图片
从事实审核流程出发,逐步检查 Mermaid 的节点标识、可见标签、判断分支与返回路径。用最小连接排查括号和语法错误,区分拼写导致的新节点与流程逻辑错误,再按展示位置调整方向、文字和尺寸;导出后核对标签裁切与箭头,同时保留流程摘要和可编辑原稿,方便团队交接。
好的流程图能让读者顺着判断往下走,不必每条箭头都找作者解释。打开 Mermaid 转图片,先从一个能核对的小流程开始。这里使用审核循环:草稿通过事实检查后导出,否则返回修改。
先写起点、判断和结果。这个示例包含四个节点:准备原稿、核对事实、导出和修改。修改路径会回到同一个判断节点。返回箭头很关键,少了它,图就可能让人误以为修改完便结束了流程。
给节点使用稳定的标识符,再用可见标签描述具体工作。这里的 Draft 和 Review 是标识符,形状内部的短语是标签。Mermaid 流程图文档解释了两者的区别,以及方向声明的写法。
第一行设定从左到右的方向。两个分支都有文字标签,读者不用单靠颜色猜测含义。这是演示流程,并不能证明某个实际版本已经通过审核。
这张图可以用于编辑交接或简短的流程文档。沿着成图中的两条路径检查:通过的分支到达导出,另一条到达修改,并回到事实审核。
如果渲染失败,先检查标签和形状周围的方括号、花括号是否配对。把图缩减到第一条连接,再逐行加回其他内容。这样可以缩小问题范围,不必同时改动所有布局设置。
如果出现意料之外的节点,比较它的标识符与原本想连接的节点。相同标识符会连接同一个节点,拼写错误却可能描述出另一个节点。图能生成但箭头指错步骤时,语法可能没问题,流程逻辑却错了。把它当成一连串判断读出来,往往更容易发现问题。
分支标签尽量简短,图的尺寸要能在目标位置读清。宽的左右流程放进窄页面时,可以考虑上下排列,或拆成几张小图。改变方向后,需要重新检查布局。
检查下载文件中的标签有没有被裁切,箭头方向是否明确。同时提供流程的文字摘要,并保留 Mermaid 原稿,方便后续修改。确认每条路径都合理后,导出审核好的 Mermaid 图。