Microsoft の Visual Studio Code 1.146 更新ページには、2026 年 11 月 13 日博士時点のドキュメントツールに関する変更が 1 件記録されています。エディターが Mermaid 11 から Mermaid 12 に移行するというものです。この変更は限定的ですが、レンダリングされた Markdown ダイアグラムをレビュー対象のエンジニアリング成果物として扱うチームに影響する可能性があります。

CTO やエンジニアリングリーダーにとっての要点は明確です。バンドルされたダイアグラムライブラリのアップグレードは、ドキュメントテスト計画に含めるべきです。これは単なるバージョンラベルの変更ではありません。プレビューの一貫性、承認、公開ワークフローに影響し得るレンダリング依存関係の変更です。

1. Mermaid 12 が Mermaid 11 を置き換える

概要

Microsoft の Visual Studio Code 更新ページでは、この移行が直接示されています。

変更前変更後
Mermaid 11Mermaid 12

Microsoft のリリース記録によると、この変更は Visual Studio Code 1.146 の一部であり、その安定版は 2026 年 11 月 11 日に公開されました。Mermaid は Markdown によく埋め込まれるテキスト定義型のダイアグラムを提供し、Visual Studio Code は Markdown 関連ツールに Mermaid レンダリングを統合しています。

したがって、この更新により、エディターの統合ダイアグラムワークフローで使用されるメジャーバージョンが変更されます。エディターをアップグレードする開発者は、この組み込み機能のために Mermaid を別途インストールしなくても、新しいメジャーバージョンを利用できます。

12.3.0 に関する Mermaid のリリース情報では、BPMN 要素図形、開いた矢印および中空円のエッジマーカー、任意指定のフローチャートエッジアニメーションなどの追加が説明されています。これらの上流機能は Mermaid 12 系統の背景を理解するうえで役立ちますが、Microsoft がバンドルするマイナーバージョンを特定するまで、チームはすべての 12.3.0 機能が Visual Studio Code で確認済みであると見なすべきではありません。

重要な理由

大規模なレンダリングライブラリの変更は、ソーステキストが変わらなくても既存のダイアグラムの見え方を変える可能性があります。レイアウト、間隔、コネクター、ラベル、スタイルはすべて、アーキテクチャ図や運用ドキュメントにおけるレビュー対象です。

これは更新を阻止する理由ではありません。重要な成果物をテストする理由です。

重要な理由： チームは、ダイアグラムの作成時に Visual Studio Code のプレビューを使用し、その後、同じファイルを別のドキュメントジェネレーターまたは継続的インテグレーションパイプラインでレンダリングすることがよくあります。これらの環境で異なる Mermaid メジャーバージョンを使用している場合、エディターのプレビューと公開結果が一致しなくなる可能性があります。

規制対象業界では、ドキュメントの一貫性はガバナンス要件です。あるレンダリング環境で承認されたダイアグラムが、別の環境で重要な差異を持つ出力を黙って生成してはなりません。

拡張機能の作成者も、Visual Studio Code の統合 Mermaid サポートと、独自の拡張機能にパッケージ化された Mermaid 依存関係を区別する必要があります。エディターを更新しても、Mermaid 対応のすべての拡張機能または外部レンダラーが同じバージョンに移行したことにはなりません。

おそらく最も重要な問題は、バージョンの整合性です。エディターのプレビュー、プルリクエストチェック、公開システムが、同じダイアグラムを異なる Mermaid リリースでレンダリングしている場合、チームはコンテンツ変更ではなく出力差異の調査にレビュー時間を費やすことになります。

エージェントファースト開発は現代の開発者ツールにおけるより広範な方向性かもしれませんが、ドキュメントの依存関係には依然として従来どおりのリリース規律が必要です。レンダリングの同等性は、引き続きエンジニアリング上の統制です。

結論

Visual Studio Code 1.146 は、統合ダイアグラムツールを Mermaid 11 から Mermaid 12 に進めます。Microsoft はメジャーバージョンの移行を確認していますが、更新項目では正確な Mermaid 12 のマイナーリリースまたはパッチリリースを特定していません。

エンタープライズチームにとっての意味：

  1. ベースラインを作成する。 Visual Studio Code 1.146 を広く展開する前に、代表的でビジネスクリティカルな Mermaid ダイアグラムの現在の出力を記録します。

  2. レンダリング出力を比較する。 解析が成功したことだけに依存せず、更新後にレイアウト、ラベル、コネクター、色、可読性をレビューします。

  3. 公開経路を確認する。 ドキュメントジェネレーターと継続的インテグレーションジョブが Mermaid 11、Mermaid 12、または別のレンダラーを使用しているかを確認します。

  4. 確認済みのサポートと上流での提供状況を分ける。 Microsoft が Mermaid 12 を確認しただけで、12.3.0 固有の機能を約束してはなりません。

  5. 受け入れた差異を記録する。 新しいレンダラーが承認済みダイアグラムを変更する場合は、更新された出力が本番ドキュメントに入る前に決定を文書化します。

Happy Coding!