用途:根据用户描述生成 Mermaid 图表文本文件(.mmd),并导出为 PNG/SVG/PDF。适用于流程图、序列图、类图、ER 图、状态图、甘特图、饼图、Git 图、C4 上下文与思维导图等。核心优势是文本语法加自动布局,不需要 x/y 坐标。
主要能力:支持通过本地 mmdc 或免安装 Kroki API 导出;提供按图表类型的参考文档;带必做的校验步骤,校验通过后才导出。
使用方式:环境准备可选本地安装 npm install -g @mermaid-js/mermaid-cli 并用 mmdc --version 检查;或仅需 curl 使用 Kroki。流程为:检查依赖(优先 mmdc,不可用则回退 Kroki)、选择图表类型、写入 .mmd 文件、执行校验、导出、报告输出路径。校验示例:mmdc -i diagram.mmd -o /tmp/test.png 2>&1;或 curl -s -X POST -H "Content-Type: text/plain" --data-binary @diagram.mmd https://kroki.io/mermaid/svg -o /tmp/test.svg。导出示例:mmdc -i diagram.mmd -o diagram.png -w 2048 --backgroundColor white;Kroki 示例:curl -X POST -H "Content-Type: text/plain" --data-binary @diagram.mmd https://kroki.io/mermaid/png -o diagram.png。
限制与注意:必须先校验再导出;常见错误包括标签特殊字符未加引号、箭头语法错误、序列图未声明参与者和子图名含空格等。技能包含首次使用时的更新检查,通过 .last_update 限频 24 小时,仅提示用户不自动拉取。文档未提供具体收费或价格信息。