GitHub stars
91.1K#2 in the directory
npm downloads / week
26.8M
Commits, last 12 months
2,832
Contributors
364
Last commit
Latest release
@mermaid-js/e…Nov 13, 2026

Overview

Mermaid is an open-source diagram-as-code tool released under the MIT license. Its GitHub repository has 91,143 stars, 9,510 forks, and 364 contributors. It is actively developed with 2,832 commits in the last 12 months. The latest release, @mermaid-js/examples@2.1.0, was published on Nov 13, 2026. On npm it is downloaded about 26.8M times per week.

Its GitHub description: Generation of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown

GitHub topics: documentationflowchartjavascripttypescriptuml-diagramsdiagramsdiagrams-as-codemindmap

Install

npm
npm install mermaid
v12.3.0

Development activity

Commits per month to the default branch over the last 12 complete months.

0200400600 Nov 2025 Dec Jan 2026 Feb Mar Apr May Jun Jul Aug Sep Oct
0200400600 Nov 2025 Feb 2026 May Aug
2,832 commits from Nov 2025 to Oct 2026.
Show data as a table
Mermaid commits per month
MonthCommits
Nov 2025143
Dec 202561
Jan 202689
Feb 2026186
Mar 2026230
Apr 2026277
May 2026435
Jun 2026327
Jul 202675
Aug 2026331
Sep 2026303
Oct 2026375

Popularity among Diagrams as code

GitHub stars for Mermaid and the most-starred alternatives.
Show data as a table
GitHub stars
ToolStars
Mermaid91,143
Diagrams42,818
D225,859
PlantUML13,425
Markmap13,260
flowchart.js8,701
Penrose8,014

Alternatives to Mermaid

  • Diagrams

    Diagram as code in Python for prototyping cloud system architectures.

    42.8K starsPythonMITMermaid vs Diagrams

  • D2

    Declarative diagram scripting language that turns text into diagrams.

    25.9K starsGoMPL-2.0Mermaid vs D2

  • PlantUML

    Generates UML, Gantt, mind map and other diagrams from plain text.

    13.4K starsJavaLGPL-3.0Mermaid vs PlantUML

  • Markmap

    Builds interactive mind maps from Markdown.

    13.3K starsTypeScriptMITMermaid vs Markmap

  • flowchart.js

    Draws SVG flowcharts from a textual description.

    8.7K starsJavaScriptMIT

  • Penrose

    Creates diagrams from mathematical notation in plain text, from Carnegie Mellon University.

    8K starsTypeScriptMIT

More comparisons: Diagrams vs Mermaid · D2 vs Mermaid · Mermaid vs PlantUML · Markmap vs Mermaid · Graphviz vs Mermaid

Mermaid FAQ

Is Mermaid open source?

Yes. Mermaid is released under the MIT license, and its source code is on GitHub.

Is Mermaid still maintained?

Yes. Mermaid is actively developed, with 2,832 commits in the last 12 months and the latest commit today.

How do I install Mermaid?

From npm: npm install mermaid.

What are the best alternatives to Mermaid?

The most popular alternatives listed in Diagrams as code are Diagrams, D2, and PlantUML. See the full ranking.

What language is Mermaid written in?

Mermaid is primarily written in TypeScript, according to GitHub.

Data: GitHub API, npm. Updated Nov 18, 2026.