A big diagram looks clear to the reader, but the renderer pays the cost — 100 nodes is the watershed. This post distills how to keep big PlantUML diagrams readable and smooth to render.
The 100-n...
一张大图看着清晰,但画图工具叫苦不迭——100 节点是分水岭。本文整理让 PlantUML 大图保持可读、渲染顺畅的「拆分哲学」。
100 节点分水岭经验值:
节点数
状态
<30
顺畅(<200ms)
30-80
偶发拥挤(500ms-1s)
80-150
边缘卡顿(1s-3s)
>150
Graphviz 卡死或崩
核心原则:超过 80 ...
Writing puml code isn’t the hard part — seeing the result while you write is. This post lays out the three real workflows for VS Code / JetBrains / Vim.
Pick an IDE based on scenario
VS...
写图代码最怕的不是写代码——是「写完之后看不到结果」。本文整理 PlantUML 在 VS Code / JetBrains / Vim 三大 IDE 的开箱即用方案。
选哪个 IDE?取决于场景
VS Code:前端 / TS / Python 同学主力,markdown + puml 一边写文档一边画图
JetBrains 全家桶(IDEA &...
PlantUML defaults to SVG, but actual doc workflows — embedded in README, printed to PDF, dropped into LaTeX — have different format requirements. This article compares every output format, best-fi...
PlantUML 默认输出 SVG,但实际写文档 / 嵌入 README / 印 PDF / 进 LaTeX 都有不同要求。这篇整理所有输出格式的差异、最佳实践、陷阱。
输出格式速查1java -jar plantuml.jar -t<FORMAT> diagram.puml
Flag
输出
用途
-tsvg
SVG
文档 ...
与其一张一张手画类图,不如让代码自己生成。这篇整理 5 种常见方案:TypeDoc、JSDoc、Doxygen、SchemaCrawler、Python 自定义 walker。
方案 1:TypeDoc(TypeScript)1npm install --save-dev typedoc
12345// typedoc.json{ "entryPoints&quo...
There are PlantUML features you always have to look up in the docs. This article collects 30 micro-features so you stop searching the manual every time.
1. Newlines in node names123456@startumlcl...
写 PlantUML 时有一些「每次都要查文档才能想起来」的小技巧。这篇按小功能维度整理 30 条,让你在写图时少走弯路。
1. 节点换行123456@startumlclass "Class\nName" as c1class Class<<Long>> as c2note right of c1 : 多行注释\n也能换行@enduml
\...
The ultimate exercise of PlantUML — a complete e-commerce order microservice, end to end, from requirements to production, with the full diagram suite.
Project backgroundWe’re designing an e-comm...