用途：以文本方式编写 Mermaid 图表源码（.mmd），再导出为 PNG/SVG/PDF。核心优势是纯文本语法、布局全自动，无需手动指定 x/y 坐标，适合图表即代码、纳入 Git 并嵌入 Markdown 的场景。
主要能力：支持 flowchart、sequenceDiagram、classDiagram、erDiagram、stateDiagram-v2、gantt、pie、gitGraph、C4Context、mindmap、journey 等类型。工作流为：检查依赖、选择图表类型、生成 .mmd、校验、导出、视觉自检、与用户评审循环、报告输出路径。
使用方式：本地需安装 mmdc 与无头 Chrome：npm install -g @mermaid-js/mermaid-cli，npx puppeteer browsers install chrome-headless-shell，mmdc --version。导出示例：mmdc -i diagram.mmd -o diagram.png -w 2048 --backgroundColor white；SVG/PDF 同理改扩展名。无本地环境时用 Kroki：curl -X POST -H "Content-Type: text/plain" --data-binary @diagram.mmd https://kroki.io/mermaid/svg -o diagram.svg（PNG 同理）。
限制：导出前必须先校验，禁止未校验直接导出；mmdc 报 Could not find Chrome 属环境问题而非语法错误，应装浏览器或改用 Kroki；Kroki 对 Mermaid 不支持 PDF，仅 PNG/SVG，PDF 需本地 mmdc；视觉自检最多 2 轮，评审循环 5 轮后建议改用 mermaid.live 微调。像素级定位、手绘风格、自由白板、严格 UML 记号等场景应改用 drawio、excalidraw、tldraw、plantuml。