SuperAPI AI 工具集

d2-diagrams

设计与创作

查看项目

更新于 10-15 23:49

技能介绍

用途:用 D2 声明式文本语言生成图表,适合架构图、流程图、决策树、类序列流程、SQL/ERD 等场景。D2 负责自动布局,用户只需描述要画什么。

主要能力:支持 dagre(默认)、elk、tala(付费)多种布局引擎;内置 100+ 主题并支持深色模式;可输出 SVG、PNG、PDF、GIF(动画);支持 watch 模式在文件变更时自动重新生成;支持形状、容器嵌套、标签、图标、提示、链接、内联样式、glob 模式、可复用 classes 与变量;可在文件内通过 d2-config 配置布局引擎、主题、内边距与 sketch 手绘风格。

安装:mise install d2 && mise use -g d2;macOS 用 brew install d2;Linux/Windows 用 curl -fsSL https://d2lang.com/install.sh | sh -s --;Go 用 go install oss.terrastruct.com/d2@latest。

基本用法:d2 diagram.d2 diagram.svg(默认 SVG);d2 diagram.d2 diagram.png;d2 --scale 2 diagram.d2 diagram.png;d2 diagram.d2 diagram.pdf;d2 diagram.d2 - 输出到 stdout。watch:d2 --watch diagram.d2 diagram.svg,或 d2 --watch --browser diagram.d2。主题:d2 themes 列出,d2 -t 101 diagram.d2 output.svg,d2 --dark-theme 200 diagram.d2 output.svg。布局:d2 layout 列出,d2 -l elk diagram.d2 output.svg。手绘:d2 --sketch diagram.d2 output.svg。

限制:首次渲染 PNG 会下载约 140 MB 的 Chromium,初次约需 1 分钟;tala 布局为付费;序列图语法不如 Mermaid 丰富,若需在 GitHub Markdown 原生渲染或追求广泛工具支持,可考虑 mermaid-diagrams。更多模式(数据库 ERD、Kubernetes 部署)、特殊形状、图层与 D2 与 Mermaid 的完整对比见 REFERENCE.md。