为什么要把 Mermaid 导出成 PNG?
Mermaid 是用文本描述图表最快的方式——但你想分享它的大多数场景(X Articles、幻灯片、文档、Issue)都无法渲染 Mermaid 源码。导出为 PNG 后,你得到一张到处看起来都一致的便携图片,对方无需任何渲染器。
你能得到什么
- 支持流程图、时序图、类图、状态图、ER 图和甘特图
- 边输入边实时预览,语法错误即时发现
- 图表配色与亮色/暗色主题保持同步
- 高分辨率 PNG,可直接复制或下载
- 纯浏览器端运行,不会上传到任何服务器
使用方法
三步把 Mermaid 转成 PNG
编写 Mermaid 图表
打开 MD2X 编辑器,添加一个 ```mermaid 代码块并写入图表定义,实时预览会随输入即时渲染。
查看渲染效果
在预览面板检查图表。图表使用主题同步配色,无论亮色还是暗色模式都能很好匹配。
复制或下载 PNG
从 Assets 面板获取渲染好的图表——复制到剪贴板或下载 PNG,即可嵌入任何地方。
使用方法
真实例子
一张流程图
```mermaid
graph TD
A[写 Markdown] --> B[复制富文本]
B --> C[粘贴到 X]
```
渲染成一张带箭头的流程图 PNG:A、B、C 三个节点按顺序连线,配色跟随你当前的亮色/暗色主题,粘贴到 X Articles 就是一张静态图。
局限与异常恢复
- 只导出 PNG:Mermaid 在内部渲染成 SVG 后由 renderSvgToPng 光栅化,复制/下载拿到的都是 PNG。
- 节点很多或标签很长时图会变宽,粘贴到 X 后可能偏小;建议拆成两张图或缩短节点文字。
- Mermaid 以 securityLevel: "strict" 初始化,图里的外链图片和点击交互会被禁用。
- 语法错误时渲染区会显示错误占位框并保留源码:按提示修正 Mermaid 语法;图太宽就减少节点;导出后模糊时确认拿到的是高分辨率 PNG 再粘贴。