用途:doc-mermaid-ascii 使用 npm 包 beautiful-mermaid,把 Mermaid 图渲染成 SVG 或 ASCII/Unicode 文本,全程无需浏览器或 DOM,可在 Node.js/Bun 中运行,适合服务端渲染和终端输出。
主要能力:支持流程图(graph/flowchart)、状态图(stateDiagram-v2)、时序图(sequenceDiagram)、类图(classDiagram)、ER 图(erDiagram)五种类型,SVG 与 ASCII 均可输出。ASCII 默认使用 Unicode 制表符,可切换纯 ASCII。内置 15 款主题(zinc-light/dark、tokyo-night 系列、catppuccin、nord、dracula、github-light/dark、solarized、one-dark 等),并支持 mono 双色模式(仅给 bg/fg,其余颜色自动派生),也可通过 fromShikiTheme 接入 Shiki 主题。
使用方式:先安装依赖:npm install beautiful-mermaid(或 bun add beautiful-mermaid)。可用附带的渲染脚本一次性输出,例如 node ~/.claude/skills/beautiful-mermaid/scripts/render.mjs diagram.mmd -o diagram.svg,加 --ascii 输出文本,加 --theme tokyo-night 指定主题,也支持 --inline 内联字符串或标准输入。编程接口方面,SVG 使用异步 renderMermaid,ASCII 使用同步 renderMermaidAscii,并提供 bg、fg、line、accent、muted、surface、border、font、padding 等渲染选项。
限制:C4、Gantt、时间线、用户旅程、思维导图、饼图、git 图等不在支持范围,需改用 doc-mermaid(mmdc)并参考其语法。具体渲染效果、性能与错误处理细节暂未提供。