DiagramPreview
稳定渲染器Live previewExportDeveloper tool

Mermaid 转 Draw.io

将常见 Mermaid 流程图和时序图转换为可编辑 draw.io XML,并提供 SVG 预览。

示例
Detected Mermaid

This input may work better in the matching tool. Open Mermaid tool

预览结果就绪
预览结果会显示在这里。

下一步可以继续

把当前预览结果带到相关工具里继续转换、排查或导出。

使用方法

  1. 1粘贴标签清晰的 Mermaid 流程图或时序图。
  2. 2检查生成的 draw.io SVG,确认节点顺序、边标签和分支没有丢失。
  3. 3下载 .drawio 文件,在 diagrams.net 里继续调整布局。
  4. 4代码文档中可保留 Mermaid 作为源码,需要视觉编辑时再使用 draw.io。

常见场景

Mermaid 迁移可编辑 README 图AI 图表整理Wiki 图表交接架构评审材料

常见问题

哪些 Mermaid 图最适合转换?

简单流程图和时序图效果最好,复杂 Mermaid 语法可能需要转换后手动整理。

为什么不直接导出 Mermaid SVG?

SVG 适合发布,但 draw.io XML 适合继续移动节点、修改标签和视觉编辑。

能从 draw.io 再转回 Mermaid 吗?

通常不可靠。建议把它看作从文本画图交接到视觉编辑的一次转换。

Mermaid to Draw.io 会把常见 Mermaid 流程图和时序图转成可编辑 diagrams.net XML。

当 AI 或 README 工作流产出 Mermaid,但后续评审、wiki 或演示需要拖拽编辑的 draw.io 文件时,这个工具很适合。

它是文本化画图和可视化维护之间的桥梁。

Demo:把 AI Mermaid 草稿转成 draw.io 文件

AI 常返回 Mermaid,因为文本紧凑。转换后可以交给习惯 diagrams.net 的团队继续编辑。

  • 转换前先缩短过长标签。
  • 如果最终要手动编辑,subgraph 不要过度复杂。
  • 转换后检查边标签是否丢失。
flowchart LR
  browser[Browser] --> app[Next.js app]
  app --> api[API route]
  api --> db[(Database)]
  api --> queue[Event queue]

什么时候应该把 Mermaid 转成 draw.io

Mermaid 适合代码评审和 docs-as-code;draw.io 更适合产品、支持、运维同学不改 Markdown 也能继续编辑图。

  • 先用 Mermaid 把结构稳定下来,再转换成 draw.io。
  • 保留 Mermaid 作为版本化源文件,draw.io 用于协作编辑。
  • 如果图需要长期追溯,建议在文档中同时保留原始 Mermaid。
flowchart LR
  Browser --> App[Next.js App]
  App --> API[API Gateway]
  API --> Queue[(Event Queue)]
  Queue --> Worker[Worker]

Mermaid 转 Draw.io 检查清单

当你需要在文档、PR、故障复盘或交接材料发布前检查源码内容时,可以使用 Mermaid 转 Draw.io。将常见 Mermaid 流程图和时序图转换为可编辑 draw.io XML,并提供 SVG 预览。

导出前建议检查标签是否可读、关系是否和源码一致、示例是否包含敏感信息,以及修改输入后预览是否仍然成立。

限制与排查

如果预览失败,先把输入缩小到最小完整示例,确认格式语法,再逐段加回内容。很多失败来自不完整文件、缩进错误、缺少图表头,或复制了依赖隐藏上下文的片段。

请把预览结果当作 review 界面,而不是生产事实来源。生成的图表、转换文件、看板和规则示例在进入正式文档或运维流程前仍需要人工确认。

可测试的示例输入

  • Flowchart: flowchart LR User[User] --> App[Web App] App --> API[API Gateway] API --> DB[(Database)]
  • Sequence: sequenceDiagram User->>App: Open page App->>API: Load data API-->>App: JSON App-->>User: Render
  • Architecture: flowchart TB Client --> CDN CDN --> Web Web --> API API --> Redis API --> PostgreSQL

工具完成度

稳定渲染器

稳定工具

这个工具已有专用渲染或预览界面,支持常用导出,适合浏览器内反复预览、修改和发布前检查。

分级不是质量打分,而是告诉用户当前工具更适合稳定导出、深度调试、快速解析,还是 AI 辅助生成。