用途:在终端中把 Mermaid 代码渲染成 PNG 并内联显示,方便对图表进行快速视觉迭代。每次生成或修改 Mermaid 代码后应立即渲染并显示,而不是询问是否需要渲染。
主要能力:脚本 render.sh 调用 mmdc(@mermaid-js/mermaid-cli)渲染,按 TERM_PROGRAM 自动检测 iTerm2 的 imgcat 或 Ghostty 的 kitten icat 显示,两者都不可用时回退为 open。支持参数:--theme(default、dark、forest、neutral,默认 default)、--width(像素,默认 1200)、--bg(背景色,默认透明)、--css(自定义样式)、--output(输出路径,默认把 .mmd 替换为 .png)。输出 Rendered: <path> 与 View: <command>,需始终把 View: 命令打印给用户,因为 Bash 工具捕获 stdout,内联图片不会自动显示。
使用方式:首次使用检查 mmdc,缺失时运行 npm install -g @mermaid-js/mermaid-cli。将 Mermaid 代码写入文件(如 /tmp/mermaid-diagram.mmd),再运行 "${CLAUDE_SKILL_DIR}/scripts/render.sh" /tmp/mermaid-diagram.mmd。用户给出文件路径时使用该路径。用户每次修改后更新 .mmd 并立即重新渲染,同一会话保持文件路径一致;mmdc 报语法错误时先显示错误并修正代码再重试。
语法参考:支持 graph 方向(TD、LR、BT、RL)、多种节点形状、连线样式、子图、style/classDef 样式;也支持 sequenceDiagram、stateDiagram-v2、erDiagram、classDiagram 等。主题可通过 --theme 或图中 %%{init: {'theme': 'dark'}}%% 设置。
限制:终端需使用 iTerm2 或 Ghostty 才能内联显示;需已安装 mmdc;资料未提供更多平台、收费或效果信息。