一、安装 mermaid
安装与 @mermaid-js/mermaid-cli 兼容的 puppeteer
pnpm add puppeteer@^25 -g
puppeteer browsers install chrome-headless-shell
安装 mermaid-cli:
# 会安装最新的版本,现在是 12.0.0 (2026-10-13 14:43:06)
npm install -g @mermaid-js/mermaid-cli
查看是否安装成功:
which mmdc # 在 Linux/macOS 上
where mmdc # 在 Windows 上
mmdc --version
二、测试的 asciidoc 文本
[mermaid, target=img/mermaid-2025-05-09-113732, format=svg]
....
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
....
[mermaid, target=img/mermaid_2025-05-09-113741, format=png]
....
sequenceDiagram
participant Client
participant Middleware
participant API Handler
Client->>Middleware: 发起请求
Middleware->>Middleware: 执行前置逻辑
Middleware->>API Handler: 自动路由匹配
API Handler->>Middleware: 返回原始数据
Middleware->>Middleware: 包装为标准格式
Middleware->>Client: 发送最终响应
....