SuperAPI AI 工具集

mermaid-to-gif

通用与其它

查看项目

更新于 10-16 07:22

技能介绍

用途:把 Mermaid 图表转成带动画的 GIF,支持 .mmd 文件,也能从 .md 文件中提取 ```mermaid 代码块,适合演示文稿、文档或社交媒体的动画视觉素材,并支持批量转换。

主要能力:四种动画风格——progressive(元素由暗到亮依次激活,默认)、highlight-walk(聚光依次扫过)、pulse-flow(边变流动虚线,适合数据流)、wave(亮度波纹扫过)。所有风格保证图表从第 1 帧起完整可见,不隐藏元素。支持 flowchart、sequence、class、state、ER、gitgraph、mindmap、pie、gantt 等图表类型。

使用方式:需 FFmpeg、Python 3.8+、Playwright(pip install playwright && playwright install chromium)。单个文件:python <skill-root>/scripts/mermaid_to_gif.py diagram.mmd;转换 .md:python <skill-root>/scripts/mermaid_to_gif.py document.md -o ./images/;多文件可传 *.mmd 或多个 .md。常用参数:-o/--output-dir、-s/--style、--fps(默认 10)、--duration(默认 4.0)、--hold、--theme、--bg、--padding、--scale(默认 2)、--custom-css、--no-loop。

处理 .md 时技能建议阅读每个 mermaid 块周围的文本语义来选择风格:数据管道用 pulse-flow,架构层次用 progressive,分步骤教程用 highlight-walk,概览/装饰用 wave。可通过多次运行按块覆盖风格。生成后可把原始代码块替换为图片引用,如 。

限制:渲染时需联网从 CDN 加载 Mermaid.js;无法识别的图表类型或无动画元素时回退为整图透明度揭示;默认 scale=2 产生约 1400-1600px 宽图像;GIF 过大时可降低 fps 至 8、缩短时长、用 --scale 1 或改用 wave 风格。其余细节资料暂未提供。