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((完了))
シーケンス図
人やシステムの間で、どんな順番でやり取りするかを表します。participant で登場するものを並べ、->> は実線の矢印、-->> は点線の矢印です。alt・else・end で場合分けも書けます。
sequenceDiagram
actor 利用者
participant 画面 as Webサイト
participant API as サーバー
利用者->>画面: ログイン情報を入力
画面->>API: 認証をリクエスト
alt 認証成功
API-->>画面: トークンを返す
else 認証失敗
API-->>画面: エラー
end
マインドマップ
アイデアの整理に使います。mindmap の下に、字下げ(インデント)の深さで枝分かれを書きます。一番上の項目は root((文字)) のように書くと丸になります。
mindmap
root((HTMLで作れる道具))
すぐ作れる
計算ツール
HTMLスライド
図を描く
Mermaid作図
マインドマップ
作り込めばできる
ペイントツール
2D CAD
ガントチャート
作業の予定を横棒で表します。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
ER図
データベースの表どうしの関係を表します。||--o{ は「1対多」のように、記号で関係の数を表します。
erDiagram
CUSTOMER ||--o{ ORDER : "注文する"
ORDER ||--|{ ORDER_ITEM : "含む"
このほかにも、クラス図・状態遷移図・円グラフ・タイムラインなど多くの種類があります。すべての書き方は公式ドキュメントで確認できます。
3. AI(Claude)で作図ツールを作る(画面で解説)
ここからは、書いた文章がその場で図になる作図ツールを、Claudeに作ってもらいます。
STEP1:ほしい機能を伝える
Claudeの入力欄に、作りたい道具と付けたい機能をまとめて書きます。この例では、次のように頼みました。
STEP2:できたツールを確かめる
この例では4分ほどで、画面の右側に作図ツールが表示されました。上には「見本を入れる」「SVGで保存」「PNGで保存」「共有用URLをコピー」が並び、頼んだ機能がそろっています。
右上の広げるボタンで、ツールを画面いっぱいに表示できます。左に書いたフローチャートの文章が、右で図になっています。
STEP3:気になるところを直してもらう
公開して試してみると、マインドマップの中心の文字が長いと途中で切れてしまうことがわかりました。そのまま同じ会話で、どこがおかしいかを伝えます。
Claudeは不具合を自分で再現して原因を調べ、修正版を作ってくれました。原因は、PNGで文字化けさせないための設定にすると、丸の中の文字が中央にそろわなくなることでした。直したあとは、長い文字でも丸の中に収まるか、PNGで保存しても文字化けしないかまで確かめています。
できあがったツールは、プレビューの右上の「コピー」の横にあるメニューから、HTMLファイルとしてダウンロードできます。
4. 公開して使えるようにする
ダウンロードしたHTMLファイルを、すぐサイトのファイル管理にアップロードします。アップロードした時点で公開され、ファイル一覧にURLが表示されます。この例では https://sugu.mysugusite.com/mermaid-editor になりました。
STEP3のように直したときは、同じ名前のファイルをアップロードし直します。上書きの確認が出るので「上書きする」を押すと、URLはそのままで中身が新しくなります。
公開したURLを開くと、Claudeのプレビューと同じツールが使えます。この記事で作った作図ツールはこちらで実際に使えます。
5. 作図ツールでできること
書き間違いを日本語で教えてくれる
括弧を閉じ忘れるなど書き方を間違えると、間違えた行の番号が赤くなり、下に日本語で説明が出ます。「この行へ移動」を押すと、その行が選ばれます。直している間は、前の図が薄く残ります。
見本から書き始められる
「見本を入れる」から図の種類を選ぶと、その書き方の見本が入ります。見本を書き換えて使えば、記法を覚えていなくても図が作れます。
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)の使い方で紹介しています。