SuperAPI AI 工具集

mermaid

通用与其它

查看项目

更新于 10-16 09:33

技能介绍

用途:用于快速校验 Mermaid 图表,通过官方 Mermaid CLI 对图表进行解析与渲染,帮助在写入 Markdown 前发现语法错误。

主要能力:提供校验脚本,可解析并渲染 Mermaid 源文件;语法无效时返回非零退出码;尽力打印基于 beautiful-mermaid 的 ASCII 预览(并非所有图表类型都支持)。

使用方式:先准备 Node.js 与 npm(用于 npx)。首次运行会通过 Puppeteer 下载无头 Chromium;若缺少 Chromium,可设置 PUPPETEER_EXECUTABLE_PATH。校验命令为:./tools/validate.sh diagram.mmd [output.svg]。省略 output.svg 时,SVG 渲染到临时文件后丢弃。推荐流程:若图表将放入 Markdown,先在独立的 diagram.mmd 中起草(该工具只校验纯 Mermaid 文件),写入或更新 diagram.mmd,运行校验脚本,按 CLI 报错修正,校验通过后再把 Mermaid 块复制进 Markdown 文件。

适用场景:需要在 Markdown 文档或其他场景中使用 Mermaid 图表,并希望事先确认语法正确的场合。

限制:依赖 Node.js、npm 与 Puppeteer 提供的 Chromium;ASCII 预览为尽力而为,部分图表类型不受支持;仅校验纯 Mermaid 文件;其他能力、收费与平台信息暂未提供。