AwesomeDataviz

Mermaid

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

Website GitHubnpm
GitHub stars
90.5K#2 in the directory
npm downloads / week
20M
Commits, last 12 months
2,472
Contributors
365
Last commit
Latest release
@mermaid-js/t…Oct 2, 2026

Overview

Mermaid is an open-source diagram-as-code tool released under the MIT license. Its GitHub repository has 90,531 stars, 9,322 forks, and 365 contributors. It is actively developed with 2,472 commits in the last 12 months. The latest release, @mermaid-js/tiny@12.1.0, was published on Oct 2, 2026. On npm it is downloaded about 20M 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.1.0

Development activity

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

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

Popularity among Diagrams as code

Mermaid 90.5K Diagrams 42.7K D2 25.6K PlantUML 13.4K Markmap 13.1K flowchart.js 8.7K Penrose 8K
Mermaid 90.5K Diagrams 42.7K D2 25.6K PlantUML 13.4K Markmap 13.1K flowchart.js 8.7K Penrose 8K
GitHub stars for Mermaid and the most-starred alternatives.
Show data as a table
ToolStars
Mermaid90,531
Diagrams42,673
D225,564
PlantUML13,352
Markmap13,147
flowchart.js8,700
Penrose7,985

Alternatives to Mermaid

  • Diagrams

    Diagram as code in Python for prototyping cloud system architectures.

    42.7K starsPythonMITMermaid vs Diagrams

  • D2

    Declarative diagram scripting language that turns text into diagrams.

    25.6K 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.1K 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,472 commits in the last 12 months and the latest commit 2 days ago.

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 Oct 4, 2026.