进阶 mermaid.ai 2026-11-12 20:48:10 · 25 阅读

第11章 创建你的第一个 Mermaid 图表

创建你的第一个图表

Mermaid 图表以文本形式编写,最终渲染成可视化图形。你只需写出结构——节点、连线、标签——布局则由 Mermaid 自动处理。

本指南将带你从零开始在编辑器中创建一个图表。如果你更想描述需求、让 AI 生成语法,可以直接阅读《用 AI 生成图表》→。

开始之前

你需要一个 Mermaid 账号。免费注册 →

Basic 套餐最多可创建 3 个图表,AI 功能有限。入门足够用了——如果达到上限,升级到 Plus 即可创建无限图表,并每年获得 300 个 AI 积分。

选择创建方式

新建图表有四种方式:

直接编写或粘贴语法——适合已有代码、或熟悉 Mermaid 语法的人。粘贴现有代码即可立即渲染,也可以从空白编辑器开始搭建。

使用模板——适合 Mermaid 新手,从一个可用的图表开始编辑,而不是从零开始。模板覆盖所有图表类型——加载一个,替换成你自己的内容即可。

Vibe 图表(AI 生成)——适合想用自然语言描述需求、让 AI 生成语法的人。输入提示词就能得到图表,之后可通过对话持续调整。详见《用 AI 生成图表》→。

语音图表(beta)——想“说”出你的图表时可以试试。口头描述图表,Mermaid 会实时转录并渲染。适合边想边说,或不动键盘快速勾画想法的场景。

创建图表

进入你的仪表盘。

点击 New diagram。

选择图表类型。不确定选哪种时,可参考下表:

想展示的内容 推荐类型 带决策分支的流程或工作流 Flowchart 系统或人物随时间的交互 Sequence diagram 数据库或数据模型 ER diagram 团队或汇报结构 Flowchart 或 block diagram 项目进度安排 Gantt chart 想法及其关系 Mindmap

编辑器会打开并加载该类型的示例图表。

认识编辑器

编辑器分为两个面板:左侧编写代码,右侧随输入实时渲染图表。开始之前有几件事值得了解:

Autosync:输入时自动同步渲染图表。如果图表很大、性能变慢,可在 More options 中关闭 autosync,准备好后手动渲染。

Local timeline:每次修改后自动保存。想撤销超出 Cmd+Z 范围的编辑时,可以从左侧面板打开 local timeline,回退到之前的版本。

Pan & zoom:方便浏览大型渲染图表而不迷失位置。在 More options 中启用,然后用触控板或滚轮移动。

Highlight sync:编辑时保持代码与图表同步。点击渲染图中的节点,编辑器中对应行会高亮;修改代码,节点也会亮起。在复杂流程图中深挖时,这个功能能帮你始终定位。适用于 flowchart 和 sequence diagram。

Diagram documentation:在新标签页打开当前图表类型的完整语法参考——知道想做什么但记不清具体语法时很有用。

编写你的第一个流程图

每个图表都以类型声明开始。流程图使用 flowchart 加方向:

方向 代码 适用场景 从左到右 LR 流程、工作流、时间线 从上到下 TD 或 TB 层级结构、组织架构图、树形图 从下到上 BT 反向层级 从右到左 RL 较少见——特定布局需求

下面是一个简单的内容审批流程:

flowchart LR A[Draft] --> B{Ready for review?} B -->|Yes| C[Send to reviewer] B -->|No| A C --> D{Approved?} D -->|Yes| E[Publish] D -->|No| A

渲染结果是一个从左到右的流程,包含两个决策点,被驳回时循环回到起草环节。

节点

节点是流程图的基本构成,形状本身带有含义:

语法 形状 适用场景 A[Label] 矩形 默认——步骤、动作、任务 A(Label) 圆角矩形 较柔和的步骤、起点和终点 A{Label} 菱形 带分支路径的决策 A((Label)) 圆形 事件、端点、连接器 A[/Label/] 平行四边形 输入或输出 A[(Label)] 圆柱体 数据库、数据存储 A[[Label]] 子程序 子流程或引用的流程

节点的 ID 和标签是分开的。ID(A)用于在连线中引用节点,标签(Label)是图表中实际渲染的文字。如果多次引用同一节点,只需定义一次标签,其余地方用 ID 即可:

flowchart LR A[Start] --> B[Review] B --> C[Done] B --> A

提示:不要用全小写的 end 作为节点 ID 或标签——它会导致流程图解析出错。请用 End、END 或其他词。

连线

连线定义节点之间的关系,连线类型本身也承载含义:

语法 渲染效果 适用场景 --> 箭头 默认的方向性流程 --- 直线 无方向的关系 -.-> 虚线箭头 可选、异步或条件路径 ==> 粗箭头 主要或关键路径 --o 圆端 聚合或“零对多”关系 --x 叉端 终止或阻断

可以给连线加标签来描述路径:

B -->|Approved| C B -->|Rejected| A

提示:如果连线标签以字母 o 或 x 开头,请在前方加空格或改为大写——否则 Mermaid 会将其解析为圆端或叉端连线。例如 -->|ok| 应写成 -->| ok| 或 -->|Ok|。

子图(Subgraph)

用 subgraph 把相关节点归入一个带标签的分组:

flowchart LR subgraph Review B[Send to reviewer] --> C{Approved?} end A[Draft] --> Review C -->|Yes| D[Publish] C -->|No| A

子图适合展示流程中的阶段、按团队或系统分组,或将子流程与主流程分离。

加载模板

如果想从一个可用的示例开始编辑,而不是从零开始:

点击右上角的书籍图标。

选择图表类型。

模板加载进编辑器,直接修改即可。

从流程图到时间线再到 Sankey 图,所有图表类型都有模板。可浏览完整模板库查看全部内容。

常见问题

图表没有渲染:代码中有语法错误,Mermaid 会高亮出问题的那一行。检查括号是否匹配、箭头是否缺失、节点引用是否正确。也可以点击左侧面板的 Mermaid AI,让它直接修复图表——它能识别并自动修正语法错误。

布局看起来不对:试着改变方向。LR(从左到右)适合流程;TD(从上到下)更适合层级结构。同一个图表换个方向,阅读体验可能大不相同。

节点标签包含特殊字符:用引号包住标签,如 A["This label has (parentheses)"]。逗号、分号及其他 Mermaid 可能尝试解析的字符都适用。

“end”这个词破坏了我的图表:改成大写 End 或 END。小写的 end 是 Mermaid 解析器中的保留字。

下一步做什么?

描述需求、让 AI 帮你写语法 用 AI 生成图表 →

应用主题或自定义配色 应用主题 →

导出为 PNG 或 SVG,或发送在线链接 分享你的图表 →

使用可视化编辑器 →

评论 (0)