Mermaid チートシート
Mermaid 言語の中核を、1 条ずつ——ソースコードは、その規則が描く図の隣に並べています。34 種類の図表タイプ、実際に使われる構文です。
このサイトのすべての図はMernyx(macOS 向けネイティブ Mermaid エディタ)が描いたものです。ブラウザで動く Mermaid.js ではなく、App のキャンバスで使うのと同じレンダラーです。
どの図にも使う 4 つのこと
方向、矢印、ノード形状、スタイル——ここではフローチャートの構文で示します。何を描くにしても、この 4 つが最初に必要になり、たいていの図表タイプで書き方も同じです。
最初の行が流れを決めます。TD と TB は同じ、LR と RL は横に走ります。
flowchart LR
A[Start] --> B[Middle] --> C[End]2 つのノードをつなぐ方法は 4 つ。実線、点線、開いた線、太い線です。
flowchart LR
A[Solid] --> B[Target]
A -.-> C[Dotted]
A --- D[Open]
A ==> E[Thick]入力した括弧がそのまま形になります。ここにある 5 つは Mernyx がふつうの箱として描くものです。
flowchart LR
A[Rectangle] --> B(Rounded)
B --> C([Stadium])
C --> D[[Subroutine]]
D --> E[(Database)]style は 1 つのノードだけを変えます。classDef は使い回せるスタイルに名前をつけます。
flowchart LR
A[Normal] --> B[Highlighted]
style B fill:#ee421d,color:#ffffff,stroke:#b32c0c
classDef quiet fill:#f0f0f3,stroke:#d4d4d8
class A quiet図表タイプの一覧
どの図表タイプにも、それぞれのページ、それぞれの構文、それぞれの規則があります。
34 種類の図表タイプ
- Flowchart11 個の規則四角、矢印、分岐——Mermaid というとき、たいていの人が思い浮かべる図。チートシートを開く
- Sequence diagram8 個の規則時間順に並ぶ、参加者どうしのメッセージ。チートシートを開く
- Class diagram6 個の規則型と、そのメンバー、そして型どうしの関係。チートシートを開く
- State diagram7 個の規則状態と、その間の遷移、そしてそのあいだの分岐。チートシートを開く
- ER diagram4 個の規則エンティティと、そのカラム、そしてエンティティ間の基数。チートシートを開く
- Mindmap4 個の規則矢印を書かずに、木になるテキストのアウトライン。チートシートを開く
- Architecture diagram4 個の規則サービスと、そのサービスが属するグループ、そしてサービス間のエッジ。チートシートを開く
- Requirement diagram4 個の規則要件と、その種類、そしてそれを満たすもの。チートシートを開く
- Block diagram4 個の規則ブロックの壁を、左から右へ読む。チートシートを開く
- Swimlane diagram4 個の規則責任ごとに 1 本ずつ割り振った処理。チートシートを開く
- Agent flow diagram4 個の規則エージェントのステップと、それぞれが何のステップか。チートシートを開く
- Use case diagram4 個の規則アクター、ユースケース、そしてそれらを囲むシステム。チートシートを開く
- Pie chart3 個の規則ラベルつきの値の一覧を、切り片で描いたもの。チートシートを開く
- Gantt chart4 個の規則タスク、セクション、日付を、時間軸に沿って並べたもの。チートシートを開く
- Quadrant chart4 個の規則2 本の軸、4 つの象限、そしてその上にプロットされた点。チートシートを開く
- Radar chart4 個の規則1 つの指標に 1 本の軸、比較する 1 つごとに 1 本の曲線。チートシートを開く
- Treemap3 個の規則入れ子の長方形で、面積がそのまま値になるもの。チートシートを開く
- Kanban diagram3 個の規則カードが並ぶ列。作業の 1 段階が 1 列です。チートシートを開く
- Packet diagram2 個の規則ネットワークパケットのビットを、項目ごとに見たもの。チートシートを開く
- Info diagram1 個の規則Mermaid のバージョン表示。Mernyx は認識しますが、まだ描画しません。チートシートを開く
- Timeline3 個の規則片側に時期、そのそばに出来事。チートシートを開く
- Sankey diagram3 個の規則1 行に 3 つのフィールドで書く流れ。チートシートを開く
- User journey3 個の規則すべてのステップにスコアがついた経路。チートシートを開く
- Venn diagram3 個の規則重なっている集合と、その共有領域。チートシートを開く
- C4 diagram3 個の規則アーキテクチャのビューを、3 段階のズームで見たもの。チートシートを開く
- Cynefin diagram3 個の規則5 つのドメイン、それぞれに決め方の違うもの。チートシートを開く
- Git graph4 個の規則ブランチの履歴を、描いてみたもの。チートシートを開く
- XY chart4 個の規則2 本の軸の上の、折れ線グラフまたは棒グラフ。チートシートを開く
- Wardley map3 個の規則コンポーネントが見えやすさと進化のうえでどこに置かれるか。チートシートを開く
- Railroad diagram4 個の規則文法の規則を、描いてみたもの。チートシートを開く
- ZenUML diagram2 個の規則メソッド呼び出しのために書かれたシーケンス図。チートシートを開く
- Event modeling diagram4 個の規則情報が時間とともにどう変わったか。チートシートを開く
- Ishikawa diagram2 個の規則ひとつの問題と、その下にある原因。チートシートを開く
- Tree view3 個の規則ディレクトリの一覧を、描いてみたもの。チートシートを開く
一致する図表タイプがありません。
Mernyx は合計で 34 種類の図表タイプを描画します。このチートシートは すべてを扱います。
よくある質問
これは Mermaid の公式ドキュメントですか
いいえ。Mermaid の公式ドキュメントは網羅的で、フローチャートのページだけで数百種類の形状に及びます。ここは核心の構文を圧縮したチートシートで、図を書きながら引くための部分です。公式ドキュメントが掘り下げる場所、このページは規則を直接出します。
図が mermaid.live と違って見えるのはなぜですか
Mermaid.js が描いたものだからです。ここにある図はすべて Mernyx 独自のエンジンで描画しています——アプリがキャンバスで使うのと同じネイティブのレンダラーです。配色も間隔もタイポグラフィも Mernyx のもので、見えているのはアプリが出力した絵そのものです。
このスニペットをほかの Mermaid ツールに貼り付けられますか
できます。各見出しの下にあるソースコードはふつうの Mermaid なので、どこでも動きます。隣にある図は Mernyx がそのソースコードを描画した結果です——イラストであって、特殊な形式ではありません。
ここではどの図表タイプを扱っていますか
このシートは Mernyx が描ける 34 種類の図表タイプを扱います——1 タイプにつき 1 ページで、上のリストからリンクしています。
Mernyx は Mermaid の機能をすべてサポートしていますか
まだではありませんし、このサイトもそれを隠しません。1.0 の後も対応範囲は広がりつづけ、機能マトリクスが 34 種類それぞれのできることを示しています——ある図表タイプでできない操作は、アプリがグレー表示にして理由を示すのではなく、そもそも用意されません。
Mernyx で開いてみる
このページのスニペットをどれか 1 つ Mernyx に貼り付けて、キャンバスでノードを動かしてみてください。ソースコードもついてきます。