Markdown支持UML
现在不少在线的Markdown编辑器都开始支持UML的序列图和流程图了,但是真正用过的才知道,这真的只是看起来很美。
大致会遇到下列坑:
1. 除了序列图和流程图,没有其他图…
2. 在流程图中,只要多出现了一个判断,那么行数就多一行。逻辑复杂后,连线相互跨越,极不美观。
3. 使用JS,导致无法离线生成其他格式文档
解决方案:
首先,在Markdown中加入UML方言,类似这个,注意其中的uml标签:
### Title3
#### Title4
line1
line2
```uml
@startuml
Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response
Alice -> Bob: Another authentication Request
Alice <-- Bob: another authentication Response
@enduml
```
然后,使用plantuml,将UML内容转为图片
最后,使用pandoc,将markdown和图片合并在一起生成其他格式的文件,就像这样:
Title3
Title4
line1
line2
以上步骤,plantuml-markdown一个命令搞定,强烈推荐!