Demo:草拟 D2 服务图
D2 适合带标签、容器和关系类型的架构图。即使还没做最终样式,预览也能确认文本是否描述了正确系统。
- 用嵌套块表达领域或部署区域。
- 关系标签写成动作或协议。
- 保持标识符稳定,避免后续编辑导致图大幅变化。
client -> gateway: HTTPS
gateway -> orders: REST
orders -> queue: publish event
queue -> worker: consume
orders -> db: SQL在專業工具工作區中編寫或貼上內容,立即使用 D2 Preview 檢查圖表、文件或資料結構。
可以。大多數預覽、檢查與匯出都優先在瀏覽器端完成;AI 類工具只會把提示詞送到已設定的 API。
確認圖表或檔案符合真實流程、標籤可讀、敏感資料已移除,且匯出的 SVG/PNG 仍適合文件 review。
工具會把技術文字或檔案變成可 review 的視覺預覽,方便放進 README、ADR、runbook、issue 和 API 文件。
D2 Preview 適合需要快速檢查圖表或結構化內容的開發者、產品經理和技術寫作者。
工作區將原始內容和預覽結果放在同一頁,方便在發布前發現語法、層級或布局問題。
此工具頁具備獨立 URL、metadata、FAQ 和相關工具入口,適合長期沉澱為可搜尋的工具頁。
D2 适合带标签、容器和关系类型的架构图。即使还没做最终样式,预览也能确认文本是否描述了正确系统。
client -> gateway: HTTPS
gateway -> orders: REST
orders -> queue: publish event
queue -> worker: consume
orders -> db: SQLD2 最好的工作流是先确认结构。节点和边正确后再加主题和布局,否则样式会掩盖缺失依赖。
# Assumption: analytics is async
api -> event_bus: order.created
event_bus -> analytics: consume當你需要在文件、PR、事故復盤或交接材料發布前檢查原始內容時,可以使用 D2 Preview。D2 Preview 的線上預覽工作區,支援範例、語法檢查和匯出操作。
匯出前建議檢查標籤是否可讀、關係是否和原始內容一致、範例是否包含敏感資訊,以及修改輸入後預覽是否仍然成立。
如果預覽失敗,先把輸入縮小到最小完整範例,確認格式語法,再逐段加回內容。
請把預覽結果視為 review 介面,而不是正式事實來源。進入文件或維運流程前仍需要人工確認。
此工具偏向快速結構檢查,適合預覽、排查與定位問題;關鍵輸出進入正式流程前仍需人工複核。
分級不是品質分數,而是說明目前工具更適合穩定匯出、深度除錯、快速解析,或 AI 輔助生成。