mermaid.cli参数速查表mmdc全部8个选项完整清单主题、宽高、背景色一次讲透【免费下载链接】mermaid.cliDevelopment has been moved to https://github.com/mermaid-js/mermaid-cli项目地址: https://gitcode.com/gh_mirrors/me/mermaid.climermaid.cli 是 Mermaid 图表的命令行渲染工具一条mmdc命令就能把.mmd图表文件导出为 SVG、PNG 或 PDF 图片。本速查表整理了 mmdc 全部 8 个选项重点讲透主题、宽高、背景色这三个最常用的参数帮你快速掌握 Mermaid CLI 参数用法。 mermaid.cli 能做什么一句话把文字写的图表变成图片文件。用 Mermaid 语法写好流程图、时序图后命令行直接渲染成可嵌入文档、PPT、网页的图片mmdc -i test/flowchart.mmd -o flowchart.svg输入是test/目录下的示例图表文件输出就是同名 SVG 图片。参数记不住随时运行mmdc -h查看内置帮助。 mmdc 全部 8 个选项速查表以下 8 个选项是渲染图表时的完整清单定义见index.js一张表记牢选项全称作用默认值-i--input输入的 mermaid 文件必填—-o--output输出文件仅支持 svg / png / pdf输入名 .svg-t--theme主题default / forest / dark / neutraldefault-w--width页面宽度整数800-H--height页面高度整数600-b--backgroundColor背景色支持颜色名、色值、transparentwhite-c--configFilemermaid 的 JSON 配置文件—-C--cssFile页面的 CSS 样式文件—另外还有-V查看版本、-h查看帮助以及进阶选项-p传入 Puppeteer 配置文件下文会讲。 三个关键参数详解主题、宽高、背景色用 -t 一键切换图表主题mmdc -i test/sequence.mmd -o sequence-forest.png -t forest内置 4 套主题default经典浅色通用场景forest蓝绿配色清爽耐看dark深色背景适合深色模式文档neutral灰调低调商务感强用 -w 和 -H 设置页面宽高这两个参数决定渲染视口大小直接影响输出图片的清晰度与排版mmdc -i test/flowchart.mmd -o flowchart.png -w 1024 -H 768 小贴士导出 PNG 时把宽度调大一些图放大会更清晰SVG 是可缩放的对宽高不太敏感。用 -b 设置背景色与透明导出mmdc -i test/flowchart.mmd -o flowchart.png -b #FFF000 mmdc -i test/flowchart.mmd -o flowchart.png -b transparent支持颜色名如red、十六进制色值如#F0F0F0transparent是必会技巧透明背景的 PNG 放进任何 PPT 或文档都不违和 三个文件类选项-c、-C、-p用 -c 加载 mermaid 配置文件想批量调整主题、节点样式、时序图边距时写一份 JSON 配置文件即可项目里的test/config.json就是现成范例{ theme: forest, flowchart: { useMaxWidth: false, htmlLabels: true }, themeCSS: .node rect { fill: red; } }使用方式mmdc -i test/flowchart.mmd -o out.png -c test/config.json用 -C 自定义页面样式传入一个 CSS 文件渲染时会被注入页面可调整字体、内边距等细节可参考项目中的test/index.css。用 -p 解决 Linux 沙箱问题在 Linux 上运行偶尔会报 No usable sandbox 错误。创建puppeteer-config.json{ args: [--no-sandbox] }再用mmdc -p puppeteer-config.json ...传入即可。⚠️ 更推荐的做法避免以 root 身份运行并保持系统内核更新。⚡ 3 个实战命令组合可直接复制使用场景命令嵌入网页文档mmdc -i test/flowchart.mmd -o flowchart.svg放进 PPT 演示mmdc -i test/flowchart.mmd -o flowchart.png -w 1024 -b transparent打印归档mmdc -i test/sequence.mmd -o sequence.pdf -t dark❓ 常见踩坑问答Q1装了之后找不到 mmdc 命令全局安装可能因权限问题未注册命令推荐本地安装npm install mermaid.cli然后用./node_modules/.bin/mmdc -h调用详见 README 中的安装说明。Q2不指定 -o 时输出什么格式默认输出与输入同名的.svg文件。Q3项目还在更新吗mermaid.cli已不再活跃维护官方开发已迁移至新包mermaid-js/mermaid-cli旧版本参数仍可参考本速查表。✅ 总结记住这一行就掌握了 mmdc 参数速查表的核心mmdc -i input.mmd -o output.png -t forest -w 1024 -H 768 -b transparent-i/-o管输入输出-t管颜值-w/-H管尺寸-b管背景-c/-C负责进阶定制——8 个选项从此不求人。【免费下载链接】mermaid.cliDevelopment has been moved to https://github.com/mermaid-js/mermaid-cli项目地址: https://gitcode.com/gh_mirrors/me/mermaid.cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考