Key differences

  • Mermaid has 2.1× as many GitHub stars as Diagrams (91.1K vs 42.8K).
  • Mermaid had more development activity over the last 12 months: 2,832 commits vs 46.
  • 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
GitHub stars
42.8K 91.1K
Commits, last 12 months
46 2.8K
Contributors
177 364
Forks
2.7K 9.5K
Show data as a table
Diagrams vs Mermaid by the numbers
MetricDiagramsMermaid
GitHub stars42,81891,143
Commits, last 12 months462,832
Contributors177364
Forks2,7309,510

Development activity

Commits per month to each default branch, last 12 complete months.

  • Diagrams
  • Mermaid
0200400600 Nov 2025 Dec Jan 2026 Feb Mar Apr May Jun Jul Aug Sep OctDiagramsMermaid
0200400600 Nov 2025 Feb 2026 May Aug DiagramsMermaid
Show data as a table
Diagrams vs Mermaid: commits per month
MonthDiagramsMermaid
Nov 20256143
Dec 2025161
Jan 2026189
Feb 20262186
Mar 20261230
Apr 20262277
May 20262435
Jun 20266327
Jul 2026375
Aug 202613331
Sep 20265303
Oct 20264375

Side by side

AttributeDiagramsMermaid
DescriptionDiagram as code in Python for prototyping cloud system architectures.Generate diagrams and flowcharts from markdown-like text definitions, with a live editor.
CategoryDiagrams as codeDiagrams as code
LicenseMITMIT
LanguagePythonTypeScript
StatusActiveActive
Latest releasev0.25.1 ()@mermaid-js/examples@2.1.0 ()
Last commit
Repository created
Open issues3171,377
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.

    42.8K starsPythonMIT

  • Mermaid

    Generate diagrams and flowcharts from markdown-like text definitions, with a live editor.

    91.1K starsTypeScriptMIT

More comparisons