跳到正文

免费工具

用 Mermaid 代码生成时序图

用 Mermaid 代码生成时序图。粘贴 sequenceDiagram 并选择“生成图表”:每个参与者都有一条生命线,每条消息按时间顺序变成箭头,注释以及 alt、loop 或 par 块会围绕它们覆盖的消息绘制。可以下载 SVG 或 PNG,也可以在 Archboard 中继续编辑。

示例输出

由 时序图 示例绘制的示例图表
试试示例订单支付流程

使用方法

  1. 粘贴 sequenceDiagram

    从 Markdown 文件、README、Pull Request 或 AI 对话的回答中复制。外面包着 mermaid 代码块标记也没问题。

  2. 查看生命线和消息

    选择“生成图表”。参与者在顶部排成一行,消息按你书写的顺序从上往下排列。

  3. 在 Archboard 中打开

    保存为新图表后,可以移动生命线、改写消息并添加注释。注册只需 Google 或 GitHub 账号。

生成器读取的时序图语法

每一行是一段 Mermaid 时序图语法,以及它在画布上变成什么:

participant A as Alias · actor U
participant 和 actor 按声明或首次使用的顺序变成生命线。as 后面写的别名会成为顶部的标签。
->> · -->> · -) · -x
实线箭头画成调用,开口箭头的虚线画成返回,开口箭头画成异步消息,以 x 结尾的箭头画成丢失的消息。
A->>A: text
参与者发给自己的消息,画成它自己生命线上的一个短循环,文字放在旁边。
alt … else … end · loop · opt · par … and
带 else 的 alt、loop、opt、带 and 的 par、critical 和 break 会变成覆盖其中消息的一个带框的块。分支条件合并在块的标签里。
Note right of A · Note over A,B
写在一个或两个参与者左侧、右侧或上方的注释,会在书写的时间点变成生命线旁边或横跨生命线的注释卡片。

生成器如何排布图表

参与者排成一行,每条消息从上到下各占一条水平线,所以代码里读到的顺序就是图上看到的顺序。生命线随消息数量变长,块包住它覆盖的消息,标签留在箭头上方。在 Archboard 中,每条生命线、每个注释和每个块都是独立的形状:把参与者拖到一边,它的消息会跟着移动,也可以把调用改成返回。

时序图不包含的内容

  • 激活条:activate、deactivate 以及箭头上的加号和减号简写会被读取,但不会画出激活条。会有一条提示说明跳过了多少个。
  • autonumber 的消息编号:每条消息保留自己的文字,前面不加编号。
  • box 分组和 rect 背景色:其中的参与者和消息会被画出,但周围的彩色色带不会。
  • 与代码的双向同步:在 Archboard 中的修改只留在 Archboard,之后修改 Mermaid 文本也不会重新绘制已保存的图表。

关于时序图的问题

可以粘贴 ChatGPT 或 Claude 写的时序图吗?

可以。AI 助手通常用 mermaid 代码块回答,即使代码块前后有文字,生成器也会读取其中的代码。如果某一行用了读取器不认识的语法,错误会指出这一行,方便你修改。

图表会有多高?

每条消息占一行,所以生命线从参与者那一行一直延伸到最后一条消息。很长的交互会生成很高的图表;在 Archboard 中可以把它拆成两个图表,或把块分开。

这个页面能读取其他类型的 Mermaid 图吗?

只能读取 sequenceDiagram。流程图、erDiagram 和 classDiagram 代码请使用 Mermaid 转可编辑图表工具。如果在这里粘贴其他类型,会有一条消息说明本页面能读取的类型。

在 Archboard 中打开图表后会怎样?

本页面上的预览不会被保存。选择“在 Archboard 中打开”后,你看到的图表(形状、标签和连线)会保存为工作区中的新图表,你可以重新排列、添加注释、分享或导出。它只是一个起点:之后对 Mermaid 代码的修改不会更新该图表。

时序图生成器免费吗?

免费。生成图表以及下载 SVG 或 PNG 都无需账号。在 Archboard 中打开需要一个免费账号。

一分钟打开画布

使用 Google 或 GitHub 登录。单席位免费,团队加入后再升级。