Diagrams vs Mermaid
A data-driven comparison of two Diagrams as code: popularity, development activity, licensing and installation. Updated .
DiagramsDiagram as code in Python for prototyping cloud system architectures.
MermaidGenerate diagrams and flowcharts from markdown-like text definitions, with a live editor.
Key differences
- Mermaid has 2.1× as many GitHub stars as Diagrams (90.5K vs 42.7K).
- Mermaid had more development activity over the last 12 months: 2,472 commits vs 48.
- Both are released under the MIT license.
- Diagrams is written primarily in Python, Mermaid in TypeScript.
- Mermaid is the older project: its repository was created in 2014, Diagrams's in 2020.
By the numbers
- Diagrams
- Mermaid
Show data as a table
| Metric | Diagrams | Mermaid |
|---|---|---|
| GitHub stars | 42,673 | 90,531 |
| Commits, last 12 months | 48 | 2,472 |
| Contributors | 178 | 365 |
| Forks | 2,732 | 9,322 |
Development activity
Commits per month to each default branch, last 12 complete months.
- Diagrams
- Mermaid
Show data as a table
| Month | Diagrams | Mermaid |
|---|---|---|
| Oct 2025 | 6 | 63 |
| Nov 2025 | 6 | 143 |
| Dec 2025 | 1 | 61 |
| Jan 2026 | 1 | 89 |
| Feb 2026 | 2 | 186 |
| Mar 2026 | 1 | 230 |
| Apr 2026 | 2 | 277 |
| May 2026 | 2 | 435 |
| Jun 2026 | 6 | 327 |
| Jul 2026 | 3 | 75 |
| Aug 2026 | 13 | 331 |
| Sep 2026 | 5 | 255 |
Side by side
| Attribute | Diagrams | Mermaid |
|---|---|---|
| Description | Diagram as code in Python for prototyping cloud system architectures. | Generate diagrams and flowcharts from markdown-like text definitions, with a live editor. |
| Category | Diagrams as code | Diagrams as code |
| License | MIT | MIT |
| Language | Python | TypeScript |
| Status | Active | Active |
| Latest release | v0.25.1 () | @mermaid-js/tiny@12.1.0 () |
| Last commit | ||
| Repository created | ||
| Open issues | 318 | 1,482 |
| Install | pip install diagrams | npm install mermaid |
Which should you choose?
Popularity and activity are only part of the story. Consider which ecosystem you work in, the chart types and interactions you need, how much data you render, and whether the license fits your project. Both tool pages list alternatives if neither is quite right.
-
Diagrams
Diagram as code in Python for prototyping cloud system architectures.
-
Mermaid
Generate diagrams and flowcharts from markdown-like text definitions, with a live editor.