进阶 mermaid.ai 2026-11-12 20:48:10 · 19 阅读

第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 有多余空白。这通常是图表尺寸问题——导出前可以试着调整图表方向,或把它拆分成几个更小的部分。

接下来做什么?

发送动态链接而不是文件 | 分享你的图表 → 把图表变成演示文稿 | 构建演示文稿 →

评论 (0)