Mermaid 快速入门
2026-11-01
Mermaid 用文字画图:写几行代码,渲染成流程图、时序图等图表。在编辑器里插入语言为 mermaid 的代码块即可。
三条规则
- 第一行声明图表类型,如
graph TD表示自上而下的流程图; - 节点用字母加方括号定义(如
A[文字]),箭头-->表示连接; - 行首
%%的是注释,不渲染。
桌面端插入代码块后自动渲染;手机端可以直接编辑源码并预览。
流程图
graph TD
A[起床] --> B{天气好吗}
B -- 是 --> C[出门跑步]
B -- 否 --> D[继续写作]
方括号是普通节点,花括号是判断分支,箭头旁两个短横线之间写分支说明。
时序图
sequenceDiagram
作者->>编辑器: 写下想法
编辑器-->>作者: 自动保存
->> 是实线箭头,-->> 是虚线箭头,冒号后面写消息内容。
状态图
stateDiagram-v2
[*] --> 构思
构思 --> 写作: 开新章
写作 --> 修订: 初稿完成
修订 --> [*]
[*] 表示开始与结束,箭头旁的冒号说明是触发条件。
更多图型见「Mermaid 常见图表速查」。
渲染不出来怎么办
多半是语法笔误:检查第一行声明是否拼写正确、箭头符号是否用全、节点文字里是否混入特殊符号。改一处看一处,比整段重写快。