Diagram as Code（ダイアグラムアズコード）

概要\n\nDiagram as Code(DaC)はテキスト形式の独自構文でダイアグラム(フローチャート・シーケンス図・ER図・状態遷移図・ガントチャート・マインドマップ・組織図・C4図等)を記述、自動レンダリング表示する手法・ツール群の総称で、伝統的なdraw.io/Visio等の手描きツールと対極的な開発文化。1991年AT&Tが公開したGraphviz(dot言語)が元祖、2009年Arnaud Roques(仏)のPlantUML(Java製、UML特化)、2014年Knut Sveidqvist(瑞)のMermaid(JS製、現GitHub標準)、2020年Excalidraw(JSON+手書き風)、2022年Terrastruct社のD2(Go製、HCL風記法)等が現代の主流。GitHub MarkdownがMermaid標準サポート(2022-02-14)を開始したことで爆発的普及、Notion/Obsidian/Logseq/HackMD/Quarto/Docusaurus/MkDocs/VSCode等のドキュメンテーションツールが標準対応、AWS CDK/Terraform Cloud/Cloudcraft等のIaCツールがアーキテクチャ図自動生成にも活用。バージョン管理(Git)で履歴追跡可、Pull Request上で図の変更レビュー可、AIアシスタント(Claude/ChatGPT)が自然言語からMermaid生成可で生産性激増。jisaku.com 含む Markdown 駆動コンテンツサイトでもMermaid統合が標準的、自動内部リンク辞書 link-dictionary.json 関連の依存グラフ記述等で活躍。\n\n## 主な特徴・仕組み\n\n- 元祖: 1991年AT&T Graphviz (dot言語)、UNIX 時代から継続使用\n- PlantUML (2009): Arnaud Roques、Java製、UML図特化、企業利用多\n- Mermaid (2014): Knut Sveidqvist、JS製、GitHub標準サポート(2022-02-14)\n- Excalidraw (2020): 手書き風、JSON保存、リアルタイム共同編集\n- D2 (2022): Terrastruct、Go製、HCL風記法、レイアウト自動最適化\n- 対応図種: フローチャート/シーケンス/クラス/ER/状態/ガント/マインドマップ\n- 統合先: Notion/Obsidian/HackMD/MkDocs/Docusaurus/Quarto/VSCode\n- AI連携: Claude/ChatGPT が自然言語からMermaid生成可、爆発的普及\n\n## スペック比較表\n\n| ツール | 公開年 | 言語 | 図種数 | ライセンス | 特徴 |\n|--------|--------|------|--------|------------|------|\n| Graphviz dot | 1991 | C | 制限 | EPL | 元祖・組版品質 |\n| PlantUML | 2009 | Java | 15+ | GPL | UML特化・企業 |\n| Mermaid | 2014 | JS | 15+ | MIT | GitHub標準・最大シェア |\n| D2 | 2022 | Go | 8+ | MPL-2.0 | レイアウト最適化 |\n| Excalidraw | 2020 | TS | 自由描画 | MIT | 手書き風・共同編集 |\n| Structurizr | 2017 | Java/DSL | C4特化 | Apache | C4 Architecture |\n| diagrams.py | 2020 | Python | クラウドアーキ | MIT | クラウド構成 |\n| Asciidoctor Diagram | 2014 | Ruby | 統合 | MIT | AsciiDoc統合 |\n\n## 具体例・対応製品\n\n- Mermaid (2014-): github.com/mermaid-js/mermaid、累計GitHub Star 70K+\n- GitHub Markdown Mermaid (2022-02-14): ```mermaid ... ``` でレンダリング\n- PlantUML (2009-): plantuml.com、企業UMLドキュメンテーション主流\n- D2 Terrastruct (2022-): d2lang.com、Modern Diagram言語、DAGレイアウト\n- Excalidraw (2020-): excalidraw.com、Visual手書き風OSS\n\n## 自作PCでの選び方・注意点\n\nDocs as Code 構築のPC環境例: (A)個人開発¥150,000構成: M3 Mac mini 16GB(¥130,000) + VS Code + Mermaid Preview拡張、(B)技術ライティング¥300,000構成: M3 Pro MacBook Pro 18GB(¥350,000) + Obsidian/Logseq + Mermaid + Excalidraw、(C)企業ドキュメンテーション¥600,000構成: Windows ThinkPad P16(¥500,000) + Confluence/Notion + PlantUML/Mermaid + 内部GitLab。GitHub Pages/Netlify/Vercel/Cloudflare Pages等の静的サイトホスティングで Mermaid 込みドキュメント無料公開可、jisaku.com も Next.js 16 + Markdown(Mermaid統合) でコンテンツ管理。Claude/ChatGPT に「このシステムのアーキテクチャをMermaidで」と指示すれば生成完了、修正反復5分で実用品質。\n\n## 関連用語との違い\n\n: GUI ツール群、ドラッグ&ドロップ操作。差分管理困難・Markdown 文書統合困難で、Diagram as Code とは哲学的対立。両者の使い分けが現実的。\n\n: テキスト原始図、等でフローチャート手書き。可搬性は高いが複雑図不可、Mermaid 等が後継。\n\n## よくある質問(FAQ)\n\n\nA: GitHub標準・モダン・JS環境ならMermaid。UML完全準拠・企業既存資産ならPlantUML。新規プロジェクトはMermaid推奨、累計GitHub Star差で勝負済み。\n\n\nA: 完全可能、「以下システムのMermaidシーケンス図」で実用品質出力。最も恩恵の大きいDaC利用法、生産性10倍。\n\n\nA: SVG出力でVector品質、A1ポスター級でも劣化なし。PNG/JPG変換は解像度指定必須、PlantUML/Graphvizは組版品質高。\n\n## まとめ\n\n- テキストでダイアグラム記述・自動レンダ\n- Mermaid(2014)/PlantUML(2009)/D2(2022)が三強\n- GitHub Markdown標準サポート(2022-02)で爆発普及\n- AI(Claude/GPT)生成で生産性激増\n- Notion/Obsidian/MkDocs等ドキュメントツール統合