第19章 Mermaid 图表导出指南:支持 PNG、SVG、PDF 及 MMD 格式
将 Mermaid 图表导出为 PNG、SVG、PDF 或 MMD 把 Mermaid 图表下载为 PNG 图片、SVG、PDF 或 .mmd 文件,方便在 Mermaid 之外使用——比如放进文档、演示文稿、报告或代码库中。
导出格式
格式 适用场景
PNG 演示文稿、文档、日常分享——随处可用 SVG 网页嵌入、打印、高分辨率场景——缩放不失真 PDF 报告、提案、发给浏览器之外的相关方 MMD 保存和分享 Mermaid 原始语法——便于版本控制或复用
PNG 导出选项 导出为 PNG 时,可以设置背景:
默认背景——使用主题的背景色 透明背景——无背景,适合把图表放到有底色的幻灯片或页面上 自定义背景色——指定具体的十六进制颜色值
在 Export → PNG options 下先选好背景,再导出。
SVG 用于网页或打印 SVG 是矢量格式:可以放大到任意尺寸而不失真。如果图表要用在印刷材料、大屏展示或网页中,建议选 SVG。 要把 SVG 嵌入网页,还可以用动态 SVG 链接代替静态导出——图表更新时链接会自动同步。分享你的图表 →
PDF 导出 PDF 导出即拿即用,格式干净,无需额外整理。适合附加到提案、插入报告,或发给不使用浏览器的相关方。
MMD 导出 MMD 会把 Mermaid 原始语法保存为 .mmd 文件。可以用它把图表存入代码仓库、把语法分享给开发者,或导入其他兼容 Mermaid 的工具。
常见问题
导出的 PNG 有像素颗粒感。高分辨率场景请改用 SVG;如有该选项,也可以调高 PNG 导出选项中的缩放比例。
我的样式和主题没有出现在导出结果里。请确认主题是在图表的 front matter 中设置的,而不只是编辑器设置——编辑器级别的主题偏好不会带入导出结果。
PDF 有多余空白。这通常是图表尺寸问题——导出前可以试着调整图表方向,或把它拆分成几个更小的部分。
接下来做什么?
发送动态链接而不是文件 | 分享你的图表 → 把图表变成演示文稿 | 构建演示文稿 →