浏览器内图片导出

Mermaid 转 PNG 转换器

将 Mermaid 源码转换为适合演示、工单、文档或消息附件的 PNG。在上方预览图表,目标需要普通位图时,点击预览右上角的 PNG 按钮。

将 Mermaid 源码转换为 PNG

下方请求确认示例适合简短 API 说明。导出前请按实际展示尺寸检查可读性。

OnUML
Loading diagram preview...

把图表作为普通图片交付

目标无法渲染 Mermaid 或不接受 SVG 时,PNG 更便于作为图片使用。固定像素使最终展示尺寸成为导出前需要考虑的因素。

普通图片附件

把导出的 PNG 用于接受标准位图的目标平台。

按主题填充背景

当前导出在深色主题使用深色背景,其他主题使用白色背景。

按渲染结果生成尺寸

图片尺寸随渲染结果和设备缩放生成,当前没有自定义宽高选项。

可以重新导出

保留源码,说明发生变化后修改图表并导出新图片。

将 Mermaid 转换为可读的 PNG

在生成固定像素图片前,先为目标文档或演示选择合适布局。

  1. 01

    粘贴 Mermaid 源码或修改请求示例,等待预览成功。

  2. 02

    检查标签长度、图表宽度与对比度,目标适合深色导出背景时再选择深色主题。

  3. 03

    点击预览右上角的 PNG 按钮,按演示或文档中的实际显示尺寸检查下载的图片。

PNG 的背景、尺寸与可读性

当前工具导出带填充背景的渲染图片,没有透明 PNG 或自定义像素尺寸预设。

PNG 图片格式指南(MDN) →

输出图片带背景

深色主题导出使用深色背景,其他主题使用白色。请在导出前选择主题,并检查是否适合目标环境,当前工具不提供透明背景。

像素尺寸随渲染结果生成

导出使用渲染尺寸,并采用最高 2 倍浏览器设备缩放,不是固定 4K 输出,也没有任意指定宽高的控件。

密集图表需要调整布局

缩短标签、调整方向或把过大的说明拆成多张图。拉伸已导出的 PNG 不会增加细节。

保留源码并按需选择 SVG

保留 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 使用与主题相关的背景,放入浅色文档前应选择浅色主题并检查文字对比度。

Mermaid 转 PNG 示例

请求确认交互包含客户、API 和数据存储,消息简短,适合在工单或演示中作为图片说明。

sequenceDiagram
    actor Customer as 客户
    participant API as 订单服务
    participant Store as 订单存储
    Customer->>API: 下单
    API->>Store: 保存已校验订单
    Store-->>API: 返回订单编号
    API-->>Customer: 确认订单
  • 图表解释调用与响应顺序,不列出全部实现步骤。
  • 请按演示或工单的显示尺寸检查消息文字,不只看放大的编辑器预览。
  • 尝试增加错误分支。如果交互变得过宽,可以拆开成功路径和恢复路径再导出。

常见问题

可以导出透明 PNG 吗?

不可以。当前 PNG 导出会填充背景:深色主题为深色,其他主题为白色。

可以指定精确宽高吗?

当前页面没有自定义像素尺寸选择器。输出随渲染尺寸生成,并采用最高 2 倍浏览器设备缩放。

为什么图片放大后模糊?

PNG 的像素数量固定。尽量按接近导出尺寸展示,简化或拆分密集内容,或者在目标支持时改用 SVG。

放大预览会设置 PNG 分辨率吗?

预览缩放用于查看图表,不是自定义导出尺寸控件。请检查下载文件在实际展示尺寸下的效果。

需要先上传文件吗?

不需要,可以直接把 Mermaid 源码粘贴到编辑器。语法错误解决后,点击预览右上角的 PNG 按钮。

可以直接在 PNG 里修改图表吗?

PNG 是渲染后的图片,不是可编辑 Mermaid 源码。修改保留的源码后重新导出。

延伸阅读

比较 Mermaid 与 PlantUML

需要为技术文档选择图表语言时,了解两者的语法与建模能力差异。

阅读图表语言比较 →