如何将PlantUML图表转换为Mermaid图表？

数据老陈

2026-8-12

从PlantUML转换为Mermaid图表的可行方法

以下是几种实用的转换方案：

使用社区开发的转换脚本
不少开发者开源了Python、Node.js等语言编写的转换脚本，核心逻辑是解析PlantUML的语法结构，将其映射为Mermaid对应的语法。这类工具通常对类图、时序图、流程图等常见图表类型支持较好。
举个类图转换的示例：
PlantUML代码：
```
class Animal {
  +name: String
  +eat(): void
}
class Dog extends Animal {
  +bark(): void
}
```
转换后的Mermaid代码：
```
classDiagram
    class Animal {
        +String name
        +eat() void
    }
    class Dog {
        +bark() void
    }
    Animal <|-- Dog
```
注意：复杂的自定义样式、特殊语法可能无法完全转换，需要手动调整。
本地部署的开源转换工具
部分开源的在线转换器支持本地部署，无需将图表数据上传到第三方平台。它们通过语法解析器完成PlantUML到Mermaid的元素映射，适合批量处理简单图表。但对于包含复杂注释、自定义布局的PlantUML文件，转换后大概率需要手动修正格式细节。
手动映射核心元素
如果图表规模不大，手动转换反而更高效，只需对应两种语法的核心元素：
- 流程图：PlantUML的start/end对应Mermaid的start/end；if分支对应Mermaid的%%if%%结构；文本标注的:语法基本通用。
- 时序图：actor定义、->消息传递语法基本一致，note left of等注释语法也可直接对应。
- 类图：调整属性和方法的格式（PlantUML是+属性名: 类型，Mermaid是+类型属性名），继承、关联关系的连线符号基本通用。