概要
Mermaidは、Markdown風text definitionからflowchart、sequence、class、state、ER、Gantt、mindmap等をrenderするTypeScript/JavaScript diagramming toolです。GitHub Markdownを含む多くのtoolへ統合され、diagramをsource textとしてversion controlできます。2026年9月16日時点のcore package最新安定版はmermaid@12.0.0です。
特徴と向いている用途
公式資料に基づく紹介・実機未検証 · 内容確認日:
20+ diagram typeをtext sourceとして管理し、docs/code reviewへ組み込む
flowchart、sequence、class、state、ER、Gantt、mindmap等をtextで記述でき、Live EditorやGitHub Markdown、application integrationでrenderできます。Built withはTypeScript + JavaScriptを表示します。
出典:[2]
12.0.0でELK default layout・新theme/look・UML use caseを導入
Mermaid 12はELKをdefault layout engineとしてbundleし、redux-color/neoのdefault appearanceを導入しました。UML use case diagramも追加され、agentflow-beta等の新しいdiagram表現も進んでいます。
出典:[3]
architectureやworkflow図をcodeと同じrepositoryでdiff/reviewしたいteamに
GUI drawing fileではなくtextをsource of truthにできるため、README・ADR・設計書・CI生成物と一緒にdiagramをversion controlしたい用途に向きます。
12.0.0はbreaking releaseで、layout・appearance・runtime floorが変わる
12.0.0はES2024、Safari 17.4+、Node.js 22.12+を要求し、default layoutがdagreからELKへ変わるため既存diagramの配置が変わり得ます。default theme/lookも変更されました。旧見た目を維持する場合はlayout/theme/lookを明示する必要があります。untrusted diagram入力ではsecurity configurationも確認します。
参考にした公式資料
- [1]mermaid-js/mermaid — GitHub repository metadata(2026-09-16)
- [2]Mermaid — README(2026-09-16)
- [3]Mermaid 12.0.0 release(2026-09-16)
編集部からの補足
v12はdefault layout/theme/lookとruntime floorが変わるbreaking releaseです。既存diagramの見た目を固定したい場合は設定を明示してください。
3ステップで試す
- 1
Live Editorを開く
packageをinstallせず、公式Live Editorで最短評価できます。
https://mermaid.live/ - 2
最初のdiagramを書く
text definitionを編集してpreviewが即時更新されることを確認します。
flowchart TD → A[Start] --> B[Done] - 3
textまたは画像として利用
GitHub Markdown等へtextを保存するか画像としてexportします。v12ではlayout/theme/lookのdefaultが変わるため、見た目を固定する場合はconfigを明示します。
Copy Mermaid text / Export SVG or PNG / Embed in Markdown
成長
成長の推移 · 直近30日
90,266 Stars
推移データを蓄積中です。
開発アクティビティ
直近90日・週次
- Commit(直近30日)
- 436
- Open PR
- 312
開発アクティビティを蓄積中です。
Built with
カテゴリとタグ
GitHubデータ
関連情報
関連記事を投稿するこのOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。
あわせて探訪
- React250,484 Stars
宣言的なコンポーネントでWebとネイティブのUIを構築するJavaScriptライブラリ。
JavaScript - n8n204,525 Stars
視覚的なキャンバスとコードを組み合わせ、サービス連携やAIエージェントを自動化するfair-code基盤。
TypeScript - Visual Studio Code(Code - OSS)192,569 Stars
Visual Studio Codeの基盤となるMITライセンスのCode - OSSリポジトリ。
TypeScript - Oh My Zsh189,748 Stars
Zshの設定をプラグイン、テーマ、自動更新の仕組みで管理するコミュニティ製フレームワーク。
Shell - Flutter178,963 Stars
Dartからmobile・web・desktopへ単一codebaseでUIを展開するBSD-3-Clauseのcross-platform SDK。
Dart
情報の誤りを報告
掲載内容に誤りや古い情報があればお知らせください。