SuperAPI AI 工具集

mermaid-render

办公与效率

查看项目

更新于 10-15 17:33

技能介绍

用途:把 Mermaid 代码或 .mmd 文件渲染成图片,支持 SVG、PNG、PDF 三种格式,默认启用手绘风格(基于 svg2roughjs,与 Mermaid Live Editor 手绘模式一致),加 --no-handdrawn 可输出标准样式。

主要能力:支持全部 Mermaid 图表类型(流程图、时序图、状态图、类图、ER 图、时间线、甘特图、思维导图等);可直接传入 Markdown 文件自动提取其中的 Mermaid 代码块;支持批量处理目录;支持 default、neutral、dark、forest 主题;支持自定义 Mermaid JSON 配置与 CSS;支持 Iconify 图标包;对中日韩文字有自动优化;手绘模式可调 roughness、bowing、hachure-gap、fill-weight,并支持铅笔滤镜与固定 seed 复现。

使用方式:脚本位于 SKILL.md 同目录,需先把 $SKILL_DIR 替换为该目录绝对路径。单文件渲染示例:node "$SKILL_DIR/scripts/render.mjs" --input diagram.mmd --output diagram.svg;标准样式加 --no-handdrawn;PNG 高分辨率加 --scale 2;PDF 加 --pdf-fit;Markdown 输入把 --output 指向目录可输出多个文件;批量用 node "$SKILL_DIR/scripts/batch.mjs" --input-dir ./diagrams --output-dir ./output。

适用场景:需要把 Mermaid 图表导出为图片、从 Markdown 文档提取并渲染图表、批量转换 .mmd 文件,或需要手绘风格示意图时。

限制:依赖 Node.js 18+,需通过 npm install 安装 puppeteer、svg2roughjs 和 @mermaid-js/mermaid-cli;puppeteer 需下载 Chromium,要求网络可用;Mermaid 语法错误需先在 mermaid.live 验证。具体收费、平台支持等信息暂未提供。