4px 网格规则
节点坐标、宽高和圆角使用四的整数倍。共享网格让各层对齐、标签留白可预测,也让手动微调继续保持一致。
✨ 基于开源 diagram-design 规范 — 即开即用的 Diagram Design 网页工作台,无需配置 CLI
在浏览器中使用 Diagram Design 工作台美化 Mermaid、导入 .drawio 文件,或用文字描述系统。生成层级清晰、连线路径精确、字体适合演示的出版级 Editorial SVG 图表。
导出图表
免费 PNG 包含 EditorialDiagram 角标。
Mermaid 记录组件关系,编辑式 Diagram Design 还会组织读者理解图表的顺序。Mermaid 美化工具针对连线、层级、颜色和字体四项视觉差距重新排版。下面用相同的十个组件,对比拥挤的源图风格与编辑式 SVG 布局。
左侧刻意展示可以避免的排版问题,并非某个编辑器的默认输出。Mermaid 与 Draw.io 都能做好样式;这里比较的是编辑设计决策,而不是编辑器能力的上限。
面向受众的 Diagram Design 让同一套系统服务不同读者。工程师模式按 1:1 保留组件,混合模式合并相关实现细节,高管模式则概括核心能力。下面展示同一系统从 24 个节点精简为 12 个,再降维为适合高管汇报的 7 个节点。
分别保留 API、数据库、缓存、适配器和 Worker 等 24 个组件。需要评审组件归属和实现依赖,再做架构决策时,应使用这一视图。
将服务与专属存储或密切相关的 Worker 配对,形成 12 项职责。访问、目录、结账、支付、交付和洞察六个能力域保持可见,减少基础设施细节。
将 12 项职责聚合为访问、目录、购物车、订单、支付、交付和洞察七个业务能力。在结账域内分别保留购物车与订单,让高管汇报仍能讨论这一决策点。涉及具体存储、重试或恢复路径时,仍需查看详细视图。
受众降维示意:24 → 12 → 7 个节点。聚合节点记录各自的原始成员;连线概括能力交接,不代表全部运行时调用。上方可交互的示例是另一套十节点系统。
这些 Diagram Design 设计技巧将编辑规范落实为可重复的间距、路径、重点、颜色和字体规则。工作台检查几何关系,并提供 4px 吸附微调,方便完成最后的修正。
节点坐标、宽高和圆角使用四的整数倍。共享网格让各层对齐、标签留白可预测,也让手动微调继续保持一致。
架构和流程图中,不共轴的连接采用横竖线段与 8px 圆角,避免箭头穿过标签。桑基图、极坐标图等定量图形保留数据表达必需的曲线。
用主要决策、集成点或瓶颈确定视觉重点,将珊瑚色留给这个故事,其余组件保持克制。移除颜色后,标签和形状仍应保留含义。
--paper 表示画布,--ink 表示正文,--muted 表示注释,--soft 表示轻边界,--accent 表示重点。更换品牌配色时,各自的语义职责保持稳定。
编辑式标题使用 Instrument Serif,组件名称使用 Geist,技术注释使用 Geist Mono。通过文字职责区分故事与实现细节,无需增加装饰。
输入公开品牌网址,提取五种语义颜色。提取器检查主文字 ink 与画布 paper 的对比度是否至少为 4.5:1,不足时修正这对颜色;整张图的可访问性仍需单独检查。
根据问题选择语法:软件关系、产品决策或定量数据。每一项都有独立可访问的指南,其中十种提供专用交互示例;其余指南解释布局规则及工作台输入准备。