DiagramPreview
基礎解析D2ArchitecturePreview workspace

D2 Preview

在專業工具工作區中編寫或貼上內容,立即使用 D2 Preview 檢查圖表、文件或資料結構。

範例
預覽結果就緒
D2 Preview 的預覽結果會顯示在這裡。

下一步可以繼續

把目前預覽結果帶到相關工具,繼續轉換、排查或匯出。

設計規範產生器

產生 Markdown 設計規範、檢查交接缺漏,並以流程圖補充說明。

開啟
AI 圖表生成器

用自然語言提示詞生成 Mermaid 圖表。

開啟
Mermaid AI 修復器

用 AI 修復 Mermaid 語法並提升圖表可讀性。

開啟

使用方法

  1. 1貼上或編寫原始內容。
  2. 2需要起步模板時選擇範例。
  3. 3檢查預覽結果,然後複製或匯出。

常見場景

技術文件架構說明AI 生成內容複核

常見問題

這個工具可以在瀏覽器中使用嗎?

可以。大多數預覽、檢查與匯出都優先在瀏覽器端完成;AI 類工具只會把提示詞送到已設定的 API。

發布前應該檢查什麼?

確認圖表或檔案符合真實流程、標籤可讀、敏感資料已移除,且匯出的 SVG/PNG 仍適合文件 review。

它如何幫助文件工作流?

工具會把技術文字或檔案變成可 review 的視覺預覽,方便放進 README、ADR、runbook、issue 和 API 文件。

D2 Preview 適合需要快速檢查圖表或結構化內容的開發者、產品經理和技術寫作者。

工作區將原始內容和預覽結果放在同一頁,方便在發布前發現語法、層級或布局問題。

此工具頁具備獨立 URL、metadata、FAQ 和相關工具入口,適合長期沉澱為可搜尋的工具頁。

Demo:草拟 D2 服务图

D2 适合带标签、容器和关系类型的架构图。即使还没做最终样式,预览也能确认文本是否描述了正确系统。

  • 用嵌套块表达领域或部署区域。
  • 关系标签写成动作或协议。
  • 保持标识符稳定,避免后续编辑导致图大幅变化。
client -> gateway: HTTPS
gateway -> orders: REST
orders -> queue: publish event
queue -> worker: consume
orders -> db: SQL

Review:先结构后美化

D2 最好的工作流是先确认结构。节点和边正确后再加主题和布局,否则样式会掩盖缺失依赖。

  • 先验证纯结构图。
  • 流程正确后再添加图标或自定义样式。
  • 用注释说明图中看不见的假设。
# Assumption: analytics is async
api -> event_bus: order.created
event_bus -> analytics: consume

D2 Preview 檢查清單

當你需要在文件、PR、事故復盤或交接材料發布前檢查原始內容時,可以使用 D2 Preview。D2 Preview 的線上預覽工作區,支援範例、語法檢查和匯出操作。

匯出前建議檢查標籤是否可讀、關係是否和原始內容一致、範例是否包含敏感資訊,以及修改輸入後預覽是否仍然成立。

限制與排查

如果預覽失敗,先把輸入縮小到最小完整範例,確認格式語法,再逐段加回內容。

請把預覽結果視為 review 介面,而不是正式事實來源。進入文件或維運流程前仍需要人工確認。

可測試的範例輸入

  • Architecture: client -> gateway -> api api -> database api -> queue
  • Service map: web: Web app api: API service db: Database web -> api -> db
  • Sequence: user -> app: request app -> api: fetch api -> app: response

工具完成度

基礎解析

基礎解析

此工具偏向快速結構檢查,適合預覽、排查與定位問題;關鍵輸出進入正式流程前仍需人工複核。

分級不是品質分數,而是說明目前工具更適合穩定匯出、深度除錯、快速解析,或 AI 輔助生成。