Mermaid 快速入门

2026-11-01

Mermaid 用文字画图:写几行代码,渲染成流程图、时序图等图表。在编辑器里插入语言为 mermaid 的代码块即可。

三条规则

  1. 第一行声明图表类型,如 graph TD 表示自上而下的流程图;
  2. 节点用字母加方括号定义(如 A[文字]),箭头 --> 表示连接;
  3. 行首 %% 的是注释,不渲染。

桌面端插入代码块后自动渲染;手机端可以直接编辑源码并预览。

流程图

graph TD
    A[起床] --> B{天气好吗}
    B -- 是 --> C[出门跑步]
    B -- 否 --> D[继续写作]

方括号是普通节点,花括号是判断分支,箭头旁两个短横线之间写分支说明。

时序图

sequenceDiagram
    作者->>编辑器: 写下想法
    编辑器-->>作者: 自动保存

->> 是实线箭头,-->> 是虚线箭头,冒号后面写消息内容。

状态图

stateDiagram-v2
    [*] --> 构思
    构思 --> 写作: 开新章
    写作 --> 修订: 初稿完成
    修订 --> [*]

[*] 表示开始与结束,箭头旁的冒号说明是触发条件。

更多图型见「Mermaid 常见图表速查」。

渲染不出来怎么办

多半是语法笔误:检查第一行声明是否拼写正确、箭头符号是否用全、节点文字里是否混入特殊符号。改一处看一处,比整段重写快。