T-CREATOR

<div />

Mermaid と PlantUML の違い: 同じ図を両方で書くと、行数はほぼ同じ。差は準備と書き出しに出た

2026年11月13日
Mermaid と PlantUML の違い: 同じ図を両方で書くと、行数はほぼ同じ。差は準備と書き出しに出た

設計の図をコードで書きたいとき、Mermaid と PlantUML のどちらを選べばよいのでしょうか? 書き方の違いを並べた比較はよく見かけますが、同じ図を書いたときに実際どれだけ手間が違うのかは分かりにくいものです。

同じシーケンス図とクラス図を両方で書き、画像に書き出しました。書いたコードの行数は、どちらもほぼ同じでした(シーケンス図で16行と17行)。違いが出たのは、動かすまでの準備と、図を表示できる場所の多さです。

環境

  • macOS 26.6.2
  • Mermaid 12.3.0(Mermaid CLI 12.2.0)
  • PlantUML 1.2026.10(Homebrew で入れたもの)
  • 2026年11月12日に確認

比べ方

同じ中身の図を2つの書き方で書きました。

図中身
シーケンス図利用者がログインし、パスワードが合うときと合わないときで、返事が分かれる
クラス図利用者、注文、管理者の3つのクラスと、継承、1対多の関係

比べたのは、書いたコードの行数と、手元で画像に書き出すまでにかかった時間です。書き出しはどちらもコマンドで行いました(Mermaid は mmdc、PlantUML は plantuml)。

結果

比べたことMermaidPlantUML
シーケンス図の行数16行17行
クラス図の行数11行12行
シーケンス図の書き出し1.6秒1.4秒
クラス図の書き出し1.2秒1.3秒
動かすのに要るものNode.js と、ブラウザーの部品(Mermaid CLI が使う)Java
GitHub の README にそのまま書いて表示されるか表示される表示されない(画像にして貼る)
VS Code のプレビュー拡張機能なしで表示される拡張機能が要る

PlantUML の行数が1行多いのは、図の始まりと終わりに @startuml と @enduml を書くためです。それを除くと、行数は同じでした。

書き出した2つの図を並べると、中身は同じで、違うのは見た目です。Mermaid はブラウザーや API を色の付いた箱で、PlantUML はデータベースを円柱の絵で描きます。

左に Mermaid、右に PlantUML で書き出したログインのシーケンス図。利用者、ブラウザー、API、データベースの4つの登場人物と、パスワードが合うときと合わないときの alt の枠が並んでいる

違いが出たところ

書く手間はほぼ同じで、違いは「どこで表示できるか」と「どう動かすか」に出ました。

観点MermaidPlantUML
書き方図の種類を1行目に書く(sequenceDiagram など)@startuml で囲み、要素の種類を行ごとに書く(actor、database など)
表示できる場所GitHub、GitLab、Notion、VS Code、多くの Markdown のエディタ専用の拡張機能や、書き出した画像
手元で動かす準備npm で入れるJava を入れてから入れる
図の種類フローチャート、シーケンス図、クラス図、ER 図、ガントチャートなどUML の図がそろっている。ほかに配置図、タイミング図など
細かい見た目の調整テーマと少しの設定細かい指定が多い

シーケンス図では、矢印の書き方が少し違うだけ

することMermaidPlantUML
呼び出しW->>A: POST ​/​loginW -> A: POST ​/​login
返事(点線)A-->>W: トークンA --> W: トークン
分かれ道alt 〜 else 〜 endalt 〜 else 〜 end
データベースの絵使えない(participant で書く)database で円柱の絵になる

2つのファイルをエディタで並べると、行ごとにほぼ対応しています。

VS Code で、左に login.mmd、右に login.puml を並べたところ。どちらも利用者、ブラウザー、API、データベースを決める行のあとに、同じ順で矢印と alt の行が続いている

Mermaid で書いたシーケンス図です。

mermaidsequenceDiagram
  actor U as 利用者
  participant W as ブラウザー
  participant A as API
  participant D as データベース
  U->>W: ログインを押す
  W->>A: POST /login
  A->>D: 利用者を探す
  D-->>A: 利用者
  alt パスワードが合う
    A-->>W: トークン
    W-->>U: マイページ
  else 合わない
    A-->>W: 401
    W-->>U: エラーを出す
  end

このコードは Mermaid プレビューに貼ると、その場で図になります。

同じ図を PlantUML で書くと、こうなります。

plantuml@startuml
actor "利用者" as U
participant "ブラウザー" as W
participant "API" as A
database "データベース" as D
U -> W: ログインを押す
W -> A: POST /login
A -> D: 利用者を探す
D --> A: 利用者
alt パスワードが合う
  A --> W: トークン
  W --> U: マイページ
else 合わない
  A --> W: 401
  W --> U: エラーを出す
end
@enduml

PlantUML のコードは PlantUML プレビューに貼ると、ブラウザだけで図にできるので、Java を入れる前に書き方を試せます。

PlantUML で書き出すと、database と書いたデータベースが円柱の絵に、actor と書いた利用者が人の絵になります。

PlantUML で書き出したシーケンス図。データベースが上と下に円柱の絵で、利用者が人の絵で描かれ、alt の枠に パスワードが合う と 合わない の2つの分かれ道がある

PlantUML は Java がないと動かない

PlantUML は Java で動きます。Homebrew で入れると Java もいっしょに入りましたが、ほかの入れ方では先に Java を用意します。

Mermaid は、Node.js があれば npm で入ります。手元で画像に書き出すときは、Mermaid CLI がブラウザーの部品を使います。入れ方は、Mermaid CLI(mmdc)のインストールと使い方に書きました。

使い分け

場面選ぶもの
GitHub の README やプルリクエストに図を書くMermaid。そのまま表示される
Notion や、Markdown のメモに図を入れるMermaid
エージェント(Claude Code など)に図を書かせるMermaid。書いたファイルを、そのまま VS Code で見られる
UML の図を、細かく正しく書く必要があるPlantUML
配置図やタイミング図など、Mermaid にない図を書くPlantUML
前から PlantUML の図がたくさんあるPlantUML のまま。書き直す手間に見合わない

エージェントに図を書かせて見る方法は、Claude Code が書いた Mermaid の図を表示する方法に書きました。

注意点

まとめ

同じ図を Mermaid と PlantUML で書くと、行数はほぼ同じでした。違いは、Mermaid は GitHub や VS Code にそのまま表示でき、PlantUML は Java の準備が要る代わりに UML の図がそろっていることです。

README やエージェントに書かせる図なら Mermaid、UML を細かく書くなら PlantUML を選んでください。 迷ったら、まず Mermaid で書き、表せない図だけ PlantUML にします。

参考文献

著書

とあるクリエイター

フロントエンドエンジニア Next.js / React / TypeScript / Node.js / Docker / AI Coding

とあるクリエイターのプロフィール