DiagramPreview
穩定渲染器Live previewExportDeveloper tool

Mermaid 轉 Draw.io

将常见 Mermaid 流程圖和时序圖轉換为可编辑 draw.io XML,并提供 SVG 預覽。

範例
預覽結果就緒
预览结果会显示在这里。

下一步可以繼續

把目前預覽結果帶到相關工具,繼續轉換、排查或匯出。

AI Mermaid 工作流text-to-mermaidmermaid-previewmermaid-ai-fixermermaid-to-drawiodrawio-preview
Mermaid Preview

Mermaid Preview 的線上預覽工作區,支援範例、語法檢查和匯出操作。

携带当前源码继续
Draw.io Viewer

Draw.io Viewer 的線上預覽工作區,支援範例、語法檢查和匯出操作。

当前输入转换成功后,可携带 XML 打开查看器。

PlantUML 轉 Draw.io

将常见 PlantUML 时序圖、组件圖、类圖、活动圖轉換为可编辑 draw.io XML,并提供 SVG 預覽。

開啟

AI Review beta

发布前做一次图表 Review

先用本地启发式检查语法、可读性、失败路径和交付风险。不会上传源码;远程 AI Review 需要用户主动提交。

本地 beta review 不发送 source、prompt 或 diagram content。

Batch conversion beta

批量转换 beta

粘贴多个 Mermaid、PlantUML 或 OpenAPI 片段,用 --- 分隔。结果会打包成 ZIP 下载,失败项会写入报告。

当前会处理 1 个片段。最多处理 12 个,适合验证批量转换需求。

Batch conversion beta

需要批量转换一批图表文件?

适合 Mermaid / PlantUML / OpenAPI 文档迁移。先登记你的文件数量和目标格式,我们会优先安排。

使用方法

  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]

搜索意图与使用边界

把 docs-as-code 里的 Mermaid 转成可编辑的 draw.io / diagrams.net 交付文件。

适合

  • README Mermaid 迁移
  • AI Mermaid 转可编辑图
  • 需要非开发同事可视化编辑的交接

不适合与常见失败

不适合

  • draw.io 可靠反转回 Mermaid
  • 要求高级 Mermaid 语法完全等价
  • 替代原始 Mermaid 源码

常见失败原因

  • 不支持的结构会停止转换
  • 超过 36 节点或 40 条关系会停止转换
  • 时序图转为关系图,不保留消息顺序

下一步工作流

Mermaid to draw.io 文档工作流

先预览 Mermaid,只转换稳定图,再检查 draw.io XML 后分享。

查看完整工作流

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 輔助生成。