美西 12 月 1 日截止
SciFig
教程··更新于

Mermaid 怎么导出图片:SVG、PNG 与 PDF 实用指南

Mermaid 怎么导出图片?用 Live Editor、mermaid-cli、VS Code 和 CI 导出 PNG、SVG、PDF 的方法,以及 PNG 模糊、过小或被裁切的解决办法。

SciFig Team
SciFig Team
SciFig 编辑团队

Mermaid 导出图片:用 Live Editor 或 mmdc 导出 PNG/SVG。

简要回答: 只导出一张图时,把图表代码粘贴到 Mermaid Live Editor,在 Actions 面板里下载 PNG 或 SVG。需要反复或批量导出时,运行 mermaid-cli 的 mmdc 命令,它可以把 .mmd 或 Markdown 文件转成 SVG、PNG 或 PDF。如果需要的是可编辑、符合期刊要求的版本,SciFig 流程图(FlowChart)会让 AI 根据你的描述重新绘制图表,每个方框、标签和箭头都可编辑,并可导出 SVG、PNG 或 PPTX。
不想安装任何软件、只想把 Mermaid 图保存为图片时,可以把代码粘贴到 SciFig Mermaid 转 PNG 工具:它在浏览器中渲染图表,可选 1×–4× 导出倍率和白色或透明背景,免费下载 PNG 或 SVG。

Mermaid 能根据文本生成图表,很适合与文档一起纳入版本管理。要把图放进论文、幻灯片或海报,还需要明确导出格式和尺寸。PNG 的像素尺寸如果不足,按预定大小打印时就可能显得模糊。

目标方法格式是否需要安装代码是否离开本机
马上导出一张图Mermaid Live Editor → Actions → PNG 或 SVGPNG、SVG否是,粘贴到托管网页中
反复或批量导出mermaid-cli(mmdc)SVG、PNG、PDFNode.js,或用 npx 运行一次否,在本地渲染
编写 Markdown 时预览VS Code 扩展或 Obsidian预览;部分扩展可导出 SVG/PNG编辑器扩展否
文档图片始终最新把 mmdc 作为 CI 构建步骤SVG、PNG、PDF在流水线中安装留在你的 CI 中
可编辑、符合期刊要求的重绘SciFig 流程图:描述图表,或把 Mermaid 文本作为 .md 文件附上,AI 重新绘制,每个方框、标签和箭头都可编辑SVG、PNG、JPG、PPTX否,在浏览器中运行是,上传到 SciFig

最后一行是另一类工具:它不渲染你的 Mermaid 代码,而是由 AI 根据描述把图表重绘为原生 SVG,每个节点、标签和箭头都是可以移动、改样式、按期刊规范排版的独立元素。免费开始,无需绑卡,首日送 150 积分,编辑以及 SVG/PNG/PPTX 导出都免费。

Mermaid 流程图的文本源码与生成的 SVG 图并排展示(图片由 SciFig 生成)
Mermaid 流程图的文本源码与生成的 SVG 图并排展示(图片由 SciFig 生成)

通过命令行导出

官方工具 @mermaid-js/mermaid-cli 提供了 mmdc 命令:
npm install -g @mermaid-js/mermaid-cli
 
mmdc -i diagram.mmd -o diagram.svg          # vector, preferred
mmdc -i diagram.mmd -o diagram.pdf          # vector PDF
mmdc -i diagram.mmd -o diagram.png -s 3     # raster at 3x scale
只要目标软件或投稿平台支持,优先选择 SVG 或 PDF。 其中的矢量线条和文字可以清晰缩放,但嵌入的位图仍受原始分辨率限制。如果必须使用 PNG,应设置缩放倍数,再按最终印刷尺寸和分辨率要求检查导出文件的像素尺寸。
格式是否支持矢量适用场景不适用的情况
SVG可容纳矢量内容网页展示、后续编辑目标平台不接受 SVG
PDF可容纳矢量内容论文、印刷、幻灯片接收文件的软件无法保留所需元素
PNG否预览,以及必须使用位图的场景像素尺寸不足以满足最终使用尺寸
mmdc 也能读取 Markdown。mmdc -i notes.md -o notes-rendered.md 会把文件中每个 mermaid 代码块渲染成图片,并另存一份引用这些图片的 Markdown——适合满是图表的 README 或实验记录。

看 AI 科研配图生成实战

看研究者如何用自然语言描述,生成可用于发表的科研配图。

探索该工具

Mermaid 怎么导出 PNG(以及 PNG 模糊、太小或被裁切怎么办)

要从 Mermaid 图表生成 PNG 文件,给 mmdc 一个以 .png 结尾的输出文件名即可。PNG 会裁到图表本身的范围,尺寸由两项设置决定:图表排版所用的页面宽度,以及缩放倍数。大多数「PNG 不好用」的问题,都能在下面找到对应的解决办法。
PNG 模糊:提高缩放倍数。 -s 会在不改变布局的情况下提高像素密度。幻灯片用 -s 2,印刷用 -s 3 或 -s 4。
mmdc -i diagram.mmd -o diagram.png -s 3
宽图里的文字太小:加宽页面。 -w 设置页面宽度(默认 800 px),-H 设置页面高度(默认 600 px)。Mermaid 会把宽图缩小到页面内,所以一张很长的从左到右流程图,标签可能小到看不清。加宽页面,标签就能保持正常大小。
mmdc -i diagram.mmd -o diagram.png -w 1600 -s 2
图被裁切或挤在一起:先导出 SVG。 如果标签被截断或过于拥挤,先渲染 SVG 并在浏览器中打开。SVG 正常,说明问题出在页面尺寸或缩放倍数;SVG 也不对,就缩短标签或换个方向(用 graph TD 代替 graph LR)。
图表背后有白底:改用透明背景。 -b 设置 PNG 和 SVG 的背景(PDF 不适用),默认是白色。
mmdc -i diagram.mmd -o diagram.png -b transparent -s 3
字体或主题不对:写进配置文件。 -c 加载 Mermaid 的 JSON 配置,让导出的每张图共用同一套字体和主题。-t 可以为单次运行选择内置主题(default、forest、dark、neutral)。
{
  "theme": "neutral",
  "themeVariables": { "fontFamily": "Arial" }
}
mmdc -i diagram.mmd -o diagram.png -c config.json -s 3
编辑器主题不会带进导出文件。 VS Code 的深色主题、Obsidian 的深色模式,或在编辑器界面里选的主题,只改变预览的样子。导出文件使用的是图表里写明的主题(init 行或前置配置),或传给 mmdc 的主题。如果导出结果和预览不一样,就把主题写进图表。
mmdc 装不上:用 npx 运行。 在权限受限的电脑上,全局安装常常失败。npx 会把命令行工具下载到缓存里运行一次,无需全局安装。首次运行还会下载一个无头浏览器,需要几分钟。
npx -y @mermaid-js/mermaid-cli -i diagram.mmd -o diagram.png -s 3

时间线图与时序图示例

下面这些最简示例都可以用同样的命令导出。分别保存为 .mmd 文件即可。
Mermaid 时间线图示例(导出图片/PNG):
timeline
    title Research project timeline
    2024 : Grant awarded
    2025 : Pilot study : Data collection
    2026 : Analysis : Manuscript submitted
mmdc -i timeline.mmd -o timeline.png -s 3
Mermaid 时序图示例:
sequenceDiagram
    participant R as Researcher
    participant S as Sequencing core
    participant P as Analysis pipeline
    R->>S: Submit samples
    S-->>R: Raw reads
    R->>P: Run QC and alignment
    P-->>R: Results table
mmdc -i sequence.mmd -o sequence.svg

其他导出方式

Mermaid Live Editor。 浏览器中的编辑器可以在 Actions 面板直接导出 SVG 和 PNG,处理单张图最快。不过这意味着要把图表粘贴到托管服务中;涉及敏感内容时,应在本地通过命令行渲染。
SciFig Mermaid 转 PNG 工具。 把 Mermaid 代码粘贴到 Mermaid 转 PNG 工具,渲染预览后下载 PNG 或 SVG。PNG 需要更清晰时,在 1×–4× 中选更高的倍率;要放到彩色幻灯片上时,选择透明背景。代码有语法错误时,工具会提示出错位置,而不是导出一张坏图,改好那一行后重新渲染即可。
VS Code。 Mermaid 预览扩展可以在编写文档时直接显示图表。不同扩展的导出能力各有差异;需要明确导出 SVG、PNG 或 PDF 时,可以使用上面的命令行方式。
CI 流水线。 mmdc 是命令行工具,因此可以加入构建流程。常见做法是把 .mmd 源文件提交到仓库,在构建文档时生成图片,让图像随源码同步更新。
- run: npm install -g @mermaid-js/mermaid-cli
- run: mmdc -i docs/architecture.mmd -o docs/architecture.svg
CI 流程示意:提交 Mermaid 源文件后,在文档构建过程中生成图片(图片由 SciFig 生成)
CI 流程示意:提交 Mermaid 源文件后,在文档构建过程中生成图片(图片由 SciFig 生成)

从 Obsidian、VS Code 导出,以及放进论文或幻灯片

Obsidian。 Obsidian 会在笔记预览中渲染 mermaid 代码块,但没有把单张图保存为图片文件的内置按钮。把笔记导出为 PDF 时,图表会一并带上。需要单独的 PNG 或 SVG 时,把代码块复制到 Mermaid Live Editor,或保存为 .mmd 文件后运行 mmdc。由于 mmdc 能读取 Markdown,也可以直接对笔记本身运行。
VS Code 与 Markdown 预览。 Mermaid 预览扩展可以边写边显示图表。要在 VS Code 中把 Markdown 里的 Mermaid 图导出为 PNG,可以使用支持导出的扩展,或把图表放在 Markdown 旁的 .mmd 文件中,在集成终端里用 mmdc 渲染。
论文与幻灯片。 导出 SVG(LaTeX 用 PDF),不要用 PNG。在 PowerPoint 中把 SVG 作为图片插入;较新版本可以把它转换为形状,方便给方框改色。在 Illustrator 或 Inkscape 中打开 SVG,调整间距、字体和箭头后再放进稿件。只有投稿系统拒收矢量文件时,才使用 -s 3 或更高倍数的 PNG。
同一张 Mermaid 流程图分别采用默认主题和 neutral 主题,比较印刷时的辨识度(图片由 SciFig 生成)
同一张 Mermaid 流程图分别采用默认主题和 neutral 主题,比较印刷时的辨识度(图片由 SciFig 生成)

调整图表外观

Mermaid 的默认样式主要面向文档。用于论文图表时,以下三项设置尤其值得检查:

  • 主题。 在图表的 YAML 前置配置中,将 config 下的主题设为 theme: neutral。确定印刷用的主题前,先按最终使用尺寸预览效果。
  • 字体。 在配置中设置 fontFamily,并确认渲染环境已安装所选字体。
  • 布局方向。 graph LR 和 graph TD 会改变图表的宽高比例。要把图放进论文的单栏版面,这项设置往往比想象中更有影响。

下面是一张使用 neutral 主题和印刷字体的研究流程图:

---
config:
  theme: neutral
  fontFamily: Helvetica
---
graph LR
  A[Sample collection] --> B[Extraction]
  B --> C[Sequencing]
  C --> D[Analysis]

什么时候该换一种绘图工具

Mermaid 会自动计算布局,能够直接控制的排版细节有限。自动布局让文档绘图更方便;但在科研插图中,元素的位置和构图本身也可能承载信息。

适合用 Mermaid改用 SciFig 流程图或矢量编辑器
纳入版本管理的技术文档必须符合期刊视觉规范的论文图
每次构建都要重新生成的图表需要逐个方框精确控制空间排布
自动布局已经够用位置要体现解剖位置、时间顺序等实际关系
审阅时能看出差异的纯文本源码合作者通过可视化方式而不是代码来编辑图

一种折中做法是先用 Mermaid 搭好结构,导出 SVG,再到矢量编辑器中完成细节。不过,手动编辑后的结果无法再仅靠 Mermaid 源码完整重现。

Mermaid 自动布局与手动调整后的论文图并排展示,图中内容相同、构图不同(图片由 SciFig 生成)
Mermaid 自动布局与手动调整后的论文图并排展示,图中内容相同、构图不同(图片由 SciFig 生成)
另一种做法是在 SciFig 流程图(FlowChart)中重绘。用自然语言描述图表,或把 Mermaid 文本作为 .md 文件附上,文字转图表工具就会让 AI 绘制一个原生 SVG 的可编辑版本,每个方框、标签和箭头都能直接移动和改样式。像上面时序图那样的交互流程,时序图生成器也能同样处理参与者和消息。免费开始,首日送 150 积分,编辑、保存以及导出 SVG、PNG 或 PPTX 都免费。如果你在为同类任务比较基于模板的设计工具,可以参考Canva 绘图替代工具。

提示

将 .mmd 源文件和导出的图片一起提交。源码便于审阅差异,也方便在内容变动后重新生成;图片则便于直接查看。只保留其中一种,就要在修改可追溯性与查看便利性之间作取舍。

立即生成科研配图

用自然语言描述你的配图需求——几分钟内得到发表级插图。

免费试用
图表之外的论文配图,可以用 SciFig 的文字生成科研插图制作插图。完整流程可参考科研成果可视化指南。

延伸阅读

相关阅读: 即时可视化:用 AI 文字转配图技术呈现复杂研究概念, 2026 年 10 款最佳科研插图工具:AI 与传统对比, 7 款免费 Canva 替代方案(2026):科研示意图绘制工具对比.

常见问题

继续了解

推荐资源

模板、工具和延伸阅读,助力你的研究

行动号召背景

准备好了吗

几分钟生成发表级科研插图

免费开始创建

免费开始 · 无需信用卡 · 为研究者打造