Diagrams usually get skipped during PR review because most teams keep them in Confluence or PowerPoint. Here’s how to push them through review the same way you push code.
Why we don’t put diagram...
PR 评审里图往往被遗漏，因为大多数团队把图放在 Confluence 或者 PPT 里。这篇讲怎么把 PlantUML 当代码一样放进 PR。
为什么不把图放进 PR最常见的几个借口：
「图是设计阶段画的，开发评审不动」
「图很大、牵一发动全身，合并时容易漏」
「评审系统看不到图，没有评审意义」
这些借口在 PlantUML + GitHub/GitLab 渲染器面前都不...
Two paths to embed PlantUML in a static blog: pre-render on the server, or have the reader’s browser render on the fly. Here’s the field guide.
Option A: Server-side render (hexo-renderer-plantum...
把 PlantUML 嵌进静态博客有两条路：本地/服务端事先渲染，或者让读者浏览器现渲染。这篇是两套方案的踩坑总结。
方案 A：服务端渲染（hexo-renderer-plantuml）工作流：<hexo> hexo generate 阶段把 ```plantuml 代码块渲染成 SVG 图片，生成的 HTML 直接包含 <svg>，不需要客户端 JS。...
不存在「最好」的图工具，只有最合适的那一个。这篇是经过几次切换后的总结。
一句话结论
类型
推荐
理由
时序图、类图、状态图、活动图、组件图、部署图、用例图
PlantUML
语法最完整，几乎所有 UML 图都有
流程图（if/else/while）、ER 图、甘特图、Git graph、架构速写
Mermaid
集成度高，GitHub/Git...
There’s no “best” diagram tool, only the right one for each situation. This is the distillation of several tool switches.
One-line conclusion
Type
Pick
Why
Sequence, class, state, activity, ...
Sequence diagrams aren’t just A -> B. The control-flow keywords are what make them useful.
alt / else — branchesThe most common pattern. alt is “if”, else is “else”:
1234567891011121314@s...
时序图不只是 A -> B，控制流关键字才是它真正有用的地方。
alt / else —— 分支最常用。alt 表示 if，else 表示 else：
1234567891011121314@startumltitle 登录返回participant FEparticipant APIFE -> API: POST /loginalt 成功 API --> ...
Default class diagrams are too loud for company docs. Here’s how to tune skinparam for a calmer look.
The default theme problemThe out-of-the-box class theme uses saturated fills and heavy border...
默认主题的 class 图在公司文档里偏花，这篇讲怎么用 skinparam 调成更克制的样式。
默认主题的问题类图默认是彩色填充 + 粗边框。在白底 wiki 里还行，在嵌入 PPT 或暗色页面里就太花。
1234567@startumlclass Animalclass Dogclass CatAnimal <|-- DogAnimal <|-- Cat@enduml
...
