Mermaidの文章からフローチャートが描かれるイメージ

Mermaidの使い方(記法の基本)と、AIで作る自分専用の作図ツール

Mermaid(マーメイド)は、文章を書くだけでフローチャートやシーケンス図、マインドマップを描ける記法です。図形を一つずつ並べる作図ソフトと違って、直したいときは文章を書き換えるだけで済みます。この記事ではMermaidの記法の基本を、図の種類ごとに紹介します。そのうえでClaudeに頼んで「書くとその場で図になる」自分専用の作図ツールを作り、公開して使うまでを実際の画面で解説します。

HTMLで作れる道具の全体像は、HTMLで便利なアプリケーションを作ろうで紹介しています。

1. Mermaidとは

Mermaidは、図をテキストで書くための記法と、それを図にするJavaScriptのライブラリです(公式サイト)。たとえば次の3行を書くと、「受付」から「確認」を経て「完了」へ進むフローチャートになります。

flowchart LR
    A[受付] --> B[確認]
    B --> C[完了]
  • 直すのがかんたん: 箱の位置や線のつなぎ方は自動で決まるので、文章を直すだけで図が整います。
  • 文章として残せる: メモや資料の中に、図の元になる文章をそのまま書いておけます。GitHubのMarkdownなど、Mermaidを図として表示できるサービスもあります。
  • AIと相性がよい: 「この手順をMermaidのフローチャートにして」と頼めば、AIが図の文章を書いてくれます。

公式の「Mermaid Live Editor」でも、ブラウザで書いて図を確かめられます。この記事では、日本語のエラー表示や見本の切り替えなど、自分が使いやすい機能を足した作図ツールを作ります。

2. Mermaidの記法の基本

1行目に図の種類を書き、2行目からその中身を書きます。よく使う5種類を紹介します。

フローチャート

手順や判断の流れを表します。flowchart TD の TD は上から下(LR なら左から右)に流す指定です。[ ] は四角、{ } はひし形(判断)、(( )) は丸になり、--> でつなぎます。|文字| で線に文字を付けられます。

flowchart TD
    A[お問い合わせ受付] --> B{内容の確認}
    B -->|見積もり依頼| C[見積書を作成]
    B -->|質問| D[担当者が回答]
    C --> E[お客様へ送付]
    D --> E
    E --> F((完了))
上のMermaidの文章から描いたフローチャート。お問い合わせ受付から内容の確認で分かれ、見積書の作成と担当者の回答を経て完了に至る

シーケンス図

人やシステムの間で、どんな順番でやり取りするかを表します。participant で登場するものを並べ、->> は実線の矢印、-->> は点線の矢印です。alt・else・end で場合分けも書けます。

sequenceDiagram
    actor 利用者
    participant 画面 as Webサイト
    participant API as サーバー
    利用者->>画面: ログイン情報を入力
    画面->>API: 認証をリクエスト
    alt 認証成功
        API-->>画面: トークンを返す
    else 認証失敗
        API-->>画面: エラー
    end
上のMermaidの文章から描いたシーケンス図。利用者がWebサイトにログイン情報を入力し、Webサイトがサーバーに認証をリクエストして、成功ならトークン、失敗ならエラーが返る

マインドマップ

アイデアの整理に使います。mindmap の下に、字下げ(インデント)の深さで枝分かれを書きます。一番上の項目は root((文字)) のように書くと丸になります。

mindmap
  root((HTMLで作れる道具))
    すぐ作れる
      計算ツール
      HTMLスライド
    図を描く
      Mermaid作図
      マインドマップ
    作り込めばできる
      ペイントツール
      2D CAD
上のMermaidの文章から描いたマインドマップ。HTMLで作れる道具を中心に、すぐ作れる・図を描く・作り込めばできるの3つに枝分かれしている

ガントチャート

作業の予定を横棒で表します。dateFormat で日付の書き方を、axisFormat で目盛りに出す日付の形を決め、after で「前の作業のあと」とつなげられます。

gantt
    title Webサイト制作スケジュール
    dateFormat YYYY-MM-DD
    axisFormat %m/%d
    section 企画
    ヒアリング   :done, a1, 2026-12-01, 3d
    構成案の作成 :a2, after a1, 4d
    section 制作
    デザイン     :b1, after a2, 7d
上のMermaidの文章から描いたガントチャート。企画のヒアリングと構成案の作成、制作のデザインが12月1日から12月15日まで横棒で並ぶ

ER図

データベースの表どうしの関係を表します。||--o{ は「1対多」のように、記号で関係の数を表します。

erDiagram
    CUSTOMER ||--o{ ORDER : "注文する"
    ORDER ||--|{ ORDER_ITEM : "含む"
上のMermaidの文章から描いたER図。CUSTOMERが0件以上のORDERを注文し、ORDERが1件以上のORDER_ITEMを含む

このほかにも、クラス図・状態遷移図・円グラフ・タイムラインなど多くの種類があります。すべての書き方は公式ドキュメントで確認できます。

3. AI(Claude)で作図ツールを作る(画面で解説)

ここからは、書いた文章がその場で図になる作図ツールを、Claudeに作ってもらいます。

STEP1:ほしい機能を伝える

Claudeの入力欄に、作りたい道具と付けたい機能をまとめて書きます。この例では、次のように頼みました。

Mermaidの作図ツールを、1つのHTMLファイルで作ってください。左にMermaidの文章を書く欄、右に図のプレビューを並べ、文章を変えるとその場で図が更新されるようにしてください。次の機能も付けてください。①「フローチャート・シーケンス図・ガントチャート・マインドマップ・ER図」の見本を選んで入れられる。②図をSVGとPNGで保存できる。③書いた文章はブラウザに自動で保存する。④「共有用URLをコピー」で、文章を入れたURLを作り、そのURLを開くと同じ図が表示される。⑤書き間違いがあるときは、どこがおかしいかを日本語で表示する。Mermaidは公式のCDNから読み込み、日本語の文字が文字化けしないようにして、スマホでは上下に並ぶようにしてください。
Claudeの入力欄に、Mermaidの作図ツールを作る依頼文を入力し、送信ボタンを押すところ

STEP2:できたツールを確かめる

この例では4分ほどで、画面の右側に作図ツールが表示されました。上には「見本を入れる」「SVGで保存」「PNGで保存」「共有用URLをコピー」が並び、頼んだ機能がそろっています。

Claudeの画面。左に依頼と返答、右にできあがった作図ツールが表示され、上に見本・保存・共有のボタンが並んでいる

右上の広げるボタンで、ツールを画面いっぱいに表示できます。左に書いたフローチャートの文章が、右で図になっています。

作図ツールを画面いっぱいに広げた様子。左にMermaidの文章、右にフローチャートが表示されている

STEP3:気になるところを直してもらう

公開して試してみると、マインドマップの中心の文字が長いと途中で切れてしまうことがわかりました。そのまま同じ会話で、どこがおかしいかを伝えます。

Claudeの入力欄に、マインドマップの中心の文字が切れるので直してほしいと入力している

Claudeは不具合を自分で再現して原因を調べ、修正版を作ってくれました。原因は、PNGで文字化けさせないための設定にすると、丸の中の文字が中央にそろわなくなることでした。直したあとは、長い文字でも丸の中に収まるか、PNGで保存しても文字化けしないかまで確かめています。

Claudeの返答。原因・直し方・確認したことが説明されている

できあがったツールは、プレビューの右上の「コピー」の横にあるメニューから、HTMLファイルとしてダウンロードできます。

4. 公開して使えるようにする

ダウンロードしたHTMLファイルを、すぐサイトのファイル管理にアップロードします。アップロードした時点で公開され、ファイル一覧にURLが表示されます。この例では https://sugu.mysugusite.com/mermaid-editor になりました。

すぐサイトのファイル一覧に表示されたmermaid-editor.html。公開URLが赤枠で囲まれている

STEP3のように直したときは、同じ名前のファイルをアップロードし直します。上書きの確認が出るので「上書きする」を押すと、URLはそのままで中身が新しくなります。

ファイルの上書き確認の画面。mermaid-editor.htmlを上書きするかを聞かれ、上書きするのボタンが赤枠で囲まれている

公開したURLを開くと、Claudeのプレビューと同じツールが使えます。この記事で作った作図ツールはこちらで実際に使えます。

公開したURLで開いた作図ツール。左にMermaidの文章、右にフローチャートが表示されている

5. 作図ツールでできること

書き間違いを日本語で教えてくれる

括弧を閉じ忘れるなど書き方を間違えると、間違えた行の番号が赤くなり、下に日本語で説明が出ます。「この行へ移動」を押すと、その行が選ばれます。直している間は、前の図が薄く残ります。

3行目の括弧の閉じ忘れで、行番号の3が赤くなり、下に書き間違いの説明が日本語で表示されている

見本から書き始められる

「見本を入れる」から図の種類を選ぶと、その書き方の見本が入ります。見本を書き換えて使えば、記法を覚えていなくても図が作れます。

見本からシーケンス図を入れた様子。左に見本の文章、右にログインの流れを表すシーケンス図が描かれている

URLで図を共有する

「共有用URLをコピー」を押すと、書いた文章を入れたURLがコピーされます。そのURLを相手に送れば、相手の画面でも同じ図が開きます。図の中身はURLの中に入っているので、サーバーに保存する必要はありません。

共有用URLをコピーのボタンを押し、共有用URLをコピーしましたと表示されている

SVG・PNGで保存する

「SVGで保存」「PNGで保存」で、描いた図を画像として保存できます。資料やスライドに貼るときに使えます。書いた文章はブラウザに自動で保存されるので、ページを閉じても続きから書けます。

6. 使う前に知っておきたい注意点

  • ネットにつながっている必要がある: このツールは、Mermaid本体をCDN(ライブラリを配っているサーバー)から読み込んでいます。オフラインでは図が描けません。
  • Mermaidのバージョンを固定する: この例では mermaid@11 を読み込んでいるので、11の中で新しい版が出ると自動で切り替わります。動きを変えたくないときは、mermaid@11.x.x のように細かい番号まで指定するようAIに頼みましょう。
  • 共有URLには図の中身が入っている: URLを知っている人は誰でも中身を見られます。社外秘の情報を入れた図は、URLで共有しないでください。
  • 保存はそのブラウザだけ: 自動保存した文章は、ブラウザのデータを消すと消えます。大事な図は、文章をコピーして残すかSVGで保存しておきましょう。

ほかの道具の作り方は、HTMLスライドの作り方でも紹介しています。

7. すぐサイトについて

最後に、この記事を書いている私たちのサービス、すぐサイトのアピールをさせてください。

すぐサイトは、HTMLファイルをアップロードするだけでホームページを公開できる、日本のホスティングサービスです。自分で作ったHTMLやAIに作ってもらったページをそのまま公開できるほか、文章と写真を入れるだけで作れる飲食店向けのテンプレートや、今のサイトをURLから取り込む機能もあります。料金は1サイト月額220円(税込)で、お店や会社のサイトなど商用にも使えます。初回30日間は無料で、クレジットカードを登録せずに試せます。

作った道具を置くだけでURLになる

AIに作ってもらったHTMLファイルを、管理画面にドラッグ&ドロップするだけで公開できます。直したファイルをアップロードし直せば、同じURLのまま最新版に置き換わります。

社内だけで使う道具にも

公開範囲は、ファイルやフォルダごとに「公開」「パスワード保護」「非公開」から選べます。社内向けの作図ツールや業務の道具も、使ってほしい人だけに共有できます。

AIに公開まで任せられる

AI連携(MCP)に対応しています。ClaudeやChatGPTに「この道具を公開して」と頼むだけで、アップロードから公開設定まで会話で進められます。接続方法はAI連携(MCP)の使い方で紹介しています。

すぐサイトを無料で始めよう

30日間の無料トライアルで、HTMLをアップロードしてすぐに公開!

無料で新規登録