Mermaid Design

ASCII 渲染

ASCII 模式把你的 Mermaid 图表变成字符画——非常适合代码注释、README 文件、PR 描述、终端输出,或任何放不了图片的地方。

切换到 ASCII 模式

点击导航栏模式切换器中的 ASCII(或直接打开 /ascii)。编辑器中同样的 Mermaid 代码会以字符而不是 SVG 渲染:

┌───────┐      ┌────────┐
│ Start │─────▶│ Ship it│
└───────┘      └────────┘

ASCII 渲染由 beautiful-mermaid 驱动(mermaid-ascii 的 TypeScript 移植版)。渲染器是懒加载的,只有首次打开 ASCII 模式时才会下载。

设置

ASCII 模式激活时,右侧面板显示 ASCII 设置:

  • 字符集——Unicode ─│┌ 使用制表符字符,线条和拐角更平滑;ASCII - | + 只使用纯 ASCII 字符,兼容性最好(旧终端、代码评审工具、纯文本邮件)。
  • 字号——缩放渲染出的文本,方便把大图表塞进狭窄的注释块。

支持的图表类型

流程图和时序图渲染效果最好。部分 Mermaid 图表类型暂时不受 ASCII 渲染器支持——这些类型会显示本地化的回退提示,而不是残缺的渲染结果。

超长连线(---->)会在渲染前自动规范化,边缘被拉长的图表也能得到合理的输出。

导出

ASCII 模式下,导出对话框提供 TXT(纯文本)——渲染好的文本图表,可以直接粘贴到任何地方。见 导出与分享。

浏览 ASCII 模板

打开 /ascii/templates 可以以 ASCII 字符画浏览模板库。不支持的模板会被自动过滤,类型筛选标签帮你快速找到起点。见 模板。