DiagramPreview
穩定渲染器Live previewExportDeveloper tool

PlantUML 轉 Draw.io

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

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

下一步可以繼續

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

PlantUML 交付工作流plantuml-previewplantuml-to-drawiodrawio-preview
PlantUML Preview

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

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

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

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

Mermaid 轉 Draw.io

将常见 Mermaid 流程圖和时序圖轉換为可编辑 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粘贴聚焦的 PlantUML 图,不要混入大量无关宏。
  2. 2检查生成的 draw.io 结构,确认主要节点和连线被保留。
  3. 3下载 .drawio 文件,在 diagrams.net 中完成布局和样式调整。
  4. 4如果 PlantUML 仍是源码事实来源,请把原始文本和转换文件一起保留。

常見場景

PlantUML 迁移可编辑时序图架构图交接diagrams.net 协作文档转换

常見問題

這個工具可以在瀏覽器中使用嗎?

可以。大多數預覽、檢查與匯出都優先在瀏覽器端完成;AI 類工具只會把提示詞送到已設定的 API。

發布前應該檢查什麼?

確認圖表或檔案符合真實流程、標籤可讀、敏感資料已移除,且匯出的 SVG/PNG 仍適合文件 review。

它如何幫助文件工作流?

工具會把技術文字或檔案變成可 review 的視覺預覽,方便放進 README、ADR、runbook、issue 和 API 文件。

PlantUML to Draw.io 会把常见 PlantUML 时序图、组件图、类图和活动图转成可编辑 diagrams.net XML。

当文本图需要交给不熟悉 PlantUML 的同事继续视觉编辑时,这个转换很有用。

PlantUML 语法很丰富,第一版重点保留主要参与者、组件、类、活动和关系,不追求像素级还原。

Demo:把时序图转换为可视化编辑文件

时序图常从 PlantUML 开始,因为文本容易 review。转成 draw.io 后,产品、支持或架构团队可以不学 PlantUML 也能调整标签和间距。

  • 参与者保持显式,避免输入中包含复杂宏。
  • 一次转换一个场景,不要把完整系统流塞进一个文件。
  • 转换后在 diagrams.net 中调整生命线间距和注释。
@startuml
actor User
participant Web
participant API
database DB
User -> Web: Submit order
Web -> API: POST /orders
API -> DB: Insert order
DB --> API: order id
API --> Web: 201 Created
@enduml

转换说明:哪些 PlantUML 结构更适合转 draw.io

PlantUML 是文本优先,draw.io 是画布优先,所以第一版转换更适合保留可编辑结构,而不是追求像素级一致。

  • sequence participant 会转换成有顺序的节点和消息连线。
  • component、class 块会转换成带标签的盒子和基础关系。
  • skinparam、note、高级宏应视作提示,而不是精确画布指令。
@startuml
actor User
participant API
database DB
User -> API: POST /orders
API -> DB: insert order
API --> User: 201 Created
@enduml

搜索意图与使用边界

把 PlantUML 源码转成可编辑的 diagrams.net 文件,用于文档交接。

适合

  • 需要可视化编辑的时序图
  • PlantUML 文档迁移到 draw.io
  • 从文本源码交接到可编辑 XML

不适合与常见失败

不适合

  • 大量远程 include 的 PlantUML 文件
  • 一个源码里塞进多页架构包
  • 可靠反向转换回 PlantUML

常见失败原因

  • include 和宏可能无法本地解析
  • 复杂 layout 指令转换后可能有差异
  • 导出后要检查参与者名称

下一步工作流

可编辑图表文档工作流

保留 PlantUML 作为源码,只转换聚焦图,并在发布前 review 生成的 draw.io 文件。

查看完整工作流

PlantUML 轉 Draw.io 檢查清單

當你需要在文件、PR、事故復盤或交接材料發布前檢查原始內容時,可以使用 PlantUML 轉 Draw.io。将常见 PlantUML 时序圖、组件圖、类圖、活动圖轉換为可编辑 draw.io XML,并提供 SVG 預覽。

匯出前建議檢查標籤是否可讀、關係是否和原始內容一致、範例是否包含敏感資訊,以及修改輸入後預覽是否仍然成立。

限制與排查

如果預覽失敗,先把輸入縮小到最小完整範例,確認格式語法,再逐段加回內容。

請把預覽結果視為 review 介面,而不是正式事實來源。進入文件或維運流程前仍需要人工確認。

可測試的範例輸入

  • Sequence: @startuml participant User participant App participant API User -> App: Submit request App -> API: Validate and persist API --> App: Result App --> User: Done @enduml
  • Component: @startuml component Web component API database PostgreSQL queue Kafka Web --> API: HTTPS API --> PostgreSQL: SQL API --> Kafka: events @enduml
  • Class: @startuml class User class Order class Payment User --> Order Order --> Payment @enduml

工具完成度

穩定渲染器

穩定工具

此工具已有專用渲染或預覽介面,支援常用匯出,適合在瀏覽器內反覆預覽、修改與發布前檢查。

分級不是品質分數,而是說明目前工具更適合穩定匯出、深度除錯、快速解析,或 AI 輔助生成。