普通图片附件
把导出的 PNG 用于接受标准位图的目标平台。
浏览器内图片导出
将 Mermaid 源码转换为适合演示、工单、文档或消息附件的 PNG。在上方预览图表,目标需要普通位图时,点击预览右上角的 PNG 按钮。
下方请求确认示例适合简短 API 说明。导出前请按实际展示尺寸检查可读性。
目标无法渲染 Mermaid 或不接受 SVG 时,PNG 更便于作为图片使用。固定像素使最终展示尺寸成为导出前需要考虑的因素。
把导出的 PNG 用于接受标准位图的目标平台。
当前导出在深色主题使用深色背景,其他主题使用白色背景。
图片尺寸随渲染结果和设备缩放生成,当前没有自定义宽高选项。
保留源码,说明发生变化后修改图表并导出新图片。
在生成固定像素图片前,先为目标文档或演示选择合适布局。
粘贴 Mermaid 源码或修改请求示例,等待预览成功。
检查标签长度、图表宽度与对比度,目标适合深色导出背景时再选择深色主题。
点击预览右上角的 PNG 按钮,按演示或文档中的实际显示尺寸检查下载的图片。
深色主题导出使用深色背景,其他主题使用白色。请在导出前选择主题,并检查是否适合目标环境,当前工具不提供透明背景。
导出使用渲染尺寸,并采用最高 2 倍浏览器设备缩放,不是固定 4K 输出,也没有任意指定宽高的控件。
缩短标签、调整方向或把过大的说明拆成多张图。拉伸已导出的 PNG 不会增加细节。
保留 Mermaid 源码便于修改。如果目标支持 SVG,且图表需要在多种尺寸下保持清晰,可改用 SVG。
这份变更审批示例包含一个判断、两条带标签的分支和一条重试回路。将完整源码粘贴到编辑器,先沿两条路径检查:拒绝后经过 Revise proposal 返回评审,通过后进入 Schedule release。把标签控制在实际工单显示尺寸下能读清的长度,再导出 PNG。
flowchart LR
Request[Receive change request] --> Review{Approved?}
Review -->|Yes| Release[Schedule release]
Review -->|No| Revise[Revise proposal]
Revise --> Review预览提示解析失败时,检查首行是否声明 flowchart LR,以及矩形的方括号和判断节点的花括号是否配对。用 Review 这类稳定 ID 标识节点,显示文字写在括号中。带标点的标签可以加引号,例如 Step["Review (manual)"]。每次小范围修改后重新渲染;重复下载不能修复源码错误。
先直接打开下载的 PNG 并查看图片尺寸。如果原图清楚,放进幻灯片后才模糊,应缩小显示尺寸,或在目标平台支持时改用 SVG。如果原图已经过密,缩短标签、把 LR 改成 TD,或拆分流程;预览缩放不是导出分辨率设置。若目标平台裁切图片,先检查它的适应或裁切选项。PNG 使用与主题相关的背景,放入浅色文档前应选择浅色主题并检查文字对比度。
请求确认交互包含客户、API 和数据存储,消息简短,适合在工单或演示中作为图片说明。
sequenceDiagram
actor Customer as 客户
participant API as 订单服务
participant Store as 订单存储
Customer->>API: 下单
API->>Store: 保存已校验订单
Store-->>API: 返回订单编号
API-->>Customer: 确认订单不可以。当前 PNG 导出会填充背景:深色主题为深色,其他主题为白色。
当前页面没有自定义像素尺寸选择器。输出随渲染尺寸生成,并采用最高 2 倍浏览器设备缩放。
PNG 的像素数量固定。尽量按接近导出尺寸展示,简化或拆分密集内容,或者在目标支持时改用 SVG。
预览缩放用于查看图表,不是自定义导出尺寸控件。请检查下载文件在实际展示尺寸下的效果。
不需要,可以直接把 Mermaid 源码粘贴到编辑器。语法错误解决后,点击预览右上角的 PNG 按钮。
PNG 是渲染后的图片,不是可编辑 Mermaid 源码。修改保留的源码后重新导出。
延伸阅读
需要为技术文档选择图表语言时,了解两者的语法与建模能力差异。
阅读图表语言比较 →