用途:该技能用于创作、渲染、排错和评审 Mermaid 图表,适用于架构文档、交互流程、过程文档与规格说明等需要可版本化图表的技术沟通场景。可在 CLI 渲染、嵌入 Markdown,或作为 HTML 片段提供,不绑定特定博客平台、主题或渲染引擎。
主要能力与图表类型:支持 flowchart(流程流、C4 变通写法、决策树)、sequence(交互协议与 API 调用)、C4 渲染(对已选定的 C4 视图做 flowchart 近似)、纵向排版(面向 PDF/打印,用 TD 而非 LR)等。资料还列出了 mmdc 间距配置、PDF 渲染管线等参考文件。GitHub 对 flowchart、sequenceDiagram、classDiagram、stateDiagram-v2、erDiagram、gantt、pie、quadrantChart、requirementDiagram、gitgraph、mindmap、timeline、zenuml、sankey、xychart、block、packet 可渲染;C4Context、C4Container、C4Component、C4Deployment、C4Dynamic 需 C4 插件,GitHub 上会以原始代码呈现。
使用方式:CLI(mmdc)输出 PDF/SVG/PNG,例如 npx @mermaid-js/mermaid-cli@11.16.0 -i diagram.mmd -o diagram.svg;需 Puppeteer 与 Chromium(约 1.7GB),可用 Docker 镜像隔离渲染。CDN 方式为引入 https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js 并初始化。还可用 Node.js 的 parse 做语法校验。
PDF 输出限制:Mermaid 代码块无法在 Pandoc → HTML → Puppeteer 管线中渲染,需先转为独立 .mmd 并预渲染为 SVG,默认使用原始内联 SVG,必要时用 base64 data URI,去除 SVG 中硬编码的 max-width 像素值,使用 TD 纵向布局并添加分页 div。
限制:正文未提供收费、价格与效果信息;语法校验和渲染成功并不等于图表适合受众,需按沟通评审检查密度、主路径、标签、颜色无关含义与无障碍回退。C4 建模决策归 c4-diagramming,架构决策归 software-architecture,完整无障碍合规归 web-accessibility。若纯文本大纲更清晰,或目标渲染器无法执行 Mermaid 且无预渲染路径,则不应使用。