Mermaid 导出图片:用 Live Editor 或 mmdc 导出 PNG/SVG。
mmdc 命令,它可以把 .mmd 或 Markdown 文件转成 SVG、PNG 或 PDF。如果需要的是可编辑、符合期刊要求的版本,SciFig 流程图(FlowChart)会让 AI 根据你的描述重新绘制图表,每个方框、标签和箭头都可编辑,并可导出 SVG、PNG 或 PPTX。Mermaid 能根据文本生成图表,很适合与文档一起纳入版本管理。要把图放进论文、幻灯片或海报,还需要明确导出格式和尺寸。PNG 的像素尺寸如果不足,按预定大小打印时就可能显得模糊。
| 目标 | 方法 | 格式 | 是否需要安装 | 代码是否离开本机 |
|---|---|---|---|---|
| 马上导出一张图 | Mermaid Live Editor → Actions → PNG 或 SVG | PNG、SVG | 否 | 是,粘贴到托管网页中 |
| 反复或批量导出 | mermaid-cli(mmdc) | SVG、PNG、PDF | Node.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-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 | 可容纳矢量内容 | 网页展示、后续编辑 | 目标平台不接受 SVG |
| 可容纳矢量内容 | 论文、印刷、幻灯片 | 接收文件的软件无法保留所需元素 | |
| PNG | 否 | 预览,以及必须使用位图的场景 | 像素尺寸不足以满足最终使用尺寸 |
mmdc 也能读取 Markdown。mmdc -i notes.md -o notes-rendered.md 会把文件中每个 mermaid 代码块渲染成图片,并另存一份引用这些图片的 Markdown——适合满是图表的 README 或实验记录。Mermaid 怎么导出 PNG(以及 PNG 模糊、太小或被裁切怎么办)
mmdc 一个以 .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 2graph 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 3mmdc 的主题。如果导出结果和预览不一样,就把主题写进图表。mmdc 装不上:用 npx 运行。 在权限受限的电脑上,全局安装常常失败。npx 会把命令行工具下载到缓存里运行一次,无需全局安装。首次运行还会下载一个无头浏览器,需要几分钟。npx -y @mermaid-js/mermaid-cli -i diagram.mmd -o diagram.png -s 3时间线图与时序图示例
.mmd 文件即可。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 3sequenceDiagram
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其他导出方式
mmdc 是命令行工具,因此可以加入构建流程。常见做法是把 .mmd 源文件提交到仓库,在构建文档时生成图片,让图像随源码同步更新。- run: npm install -g @mermaid-js/mermaid-cli
- run: mmdc -i docs/architecture.mmd -o docs/architecture.svg
从 Obsidian、VS Code 导出,以及放进论文或幻灯片
mermaid 代码块,但没有把单张图保存为图片文件的内置按钮。把笔记导出为 PDF 时,图表会一并带上。需要单独的 PNG 或 SVG 时,把代码块复制到 Mermaid Live Editor,或保存为 .mmd 文件后运行 mmdc。由于 mmdc 能读取 Markdown,也可以直接对笔记本身运行。.mmd 文件中,在集成终端里用 mmdc 渲染。-s 3 或更高倍数的 PNG。
调整图表外观
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 源码完整重现。

.md 文件附上,文字转图表工具就会让 AI 绘制一个原生 SVG 的可编辑版本,每个方框、标签和箭头都能直接移动和改样式。像上面时序图那样的交互流程,时序图生成器也能同样处理参与者和消息。免费开始,首日送 150 积分,编辑、保存以及导出 SVG、PNG 或 PPTX 都免费。如果你在为同类任务比较基于模板的设计工具,可以参考Canva 绘图替代工具。提示
.mmd 源文件和导出的图片一起提交。源码便于审阅差异,也方便在内容变动后重新生成;图片则便于直接查看。只保留其中一种,就要在修改可追溯性与查看便利性之间作取舍。延伸阅读
相关阅读: 即时可视化:用 AI 文字转配图技术呈现复杂研究概念, 2026 年 10 款最佳科研插图工具:AI 与传统对比, 7 款免费 Canva 替代方案(2026):科研示意图绘制工具对比.



