正在加载陈远的个人网站

docu.md 让 PlantUML 架构图更易读

通过更友好的连线布局与渲染,让复杂架构图减少交叉、更便于理解。

研发效能架构与基础设施

来源摘录

👍 强烈推荐 @xicilion 大佬的 Markdwon 插件 (https://t.co/fCAgfmUVUD) , 终于找到一个能让 plantuml 渲染的线条不打架人类可读的了。图一是插件渲染后的,图二是原版 https://t.co/O45Z2mPDKx

docu.md 让 PlantUML 架构图更易读,来源媒体第 1 张,共 2 张docu.md 让 PlantUML 架构图更易读,来源媒体第 2 张,共 2 张

深度解析

是什么

这是对 docu.md Markdown 插件的一次实用推荐。推文关注的不是能否生成 PlantUML,而是渲染后的连线是否互相打架、读者能否快速理解架构关系。配图把同一套 Run/Session 架构的两种结果并置:改进版更规整,原版则出现弯曲、拥挤和跨区域连线。

核心设计

docu.md 的产品链路是“AI 输出 Markdown → 实时渲染富内容 → 导出可交付文档”。站点宣称支持 PlantUML、Mermaid、Vega、draw.io、Canvas、Infographic、Graphviz 等七类图表引擎,并提供 DOCX、PDF、HTML 与图像/矢量图导出。这里最有价值的设计点,是把自动布局、路径避让、标签位置和信息层级当成文档体验的一部分,而不是把图表当作代码块原样显示。

关键洞察

架构图的“正确”只是底线;降低交叉线、保留空白、让箭头方向和组件边界清晰,才能减少认知负担。对于 AI 生成的技术文档,这种后处理尤其关键:内容生产可以自动化,但沟通质量仍取决于最终可读性。

边界与风险

配图只证明一个复杂案例的视觉改善,不能外推所有拓扑都能自动排得更好;更宽松的布局也可能牺牲紧凑度或改变读者预期的路径。站点关于本地处理、免费和 GPLv3 的说明仍需结合实际版本、浏览器插件和导出结果验证。工具能改善呈现,却不能替代清晰的领域建模与事件命名。