Skip to content
JS
Package

mermaid

Markdown-ish syntax for generating flowcharts, mindmaps, sequence diagrams, class diagrams, gantt charts, git graphs and more.

v12.0.0, 10 Sept 2026MITESM onlyTypes: BundledMarkdown
$ npm install mermaid
npmGitHubHomepage

Key numbers

As of 25 Sept 2026
Weekly downloads
11.7m
+606% over 12 months
Gzip bundle size
-
No Bundlephobia data
Dependencies
23
Direct, from package.json
Last release
14 days ago
v12.0.0
GitHub stars
90.4k
9.3k forks
Open issues / PRs
1,482 / 340
Contributors
-
Commits, last 52 weeks
2,408

Downloads

Last week 2026-09-15 to 2026-09-21
05m10m15m20mSept 2025Mar 2026Sept 2026High 15.2m (25 Aug 2026)Low 1.4m (23 Dec 2025)
Weekly npm downloads, one point per week, weeks starting 23 Sept 2025 to 15 Sept 2026. The y axis starts at zero.

11,734,476 downloads last week, 54,606,124 in the last month. The 12-month change of +606% compares the average of the last 4 weeks with the first 4 weeks of the series.

Maintenance

Releases, last 12 months
15178 in total
Latest version
12.0.0, 10 Sept 202614 days ago
First published
2 Dec 2014
Last push to GitHub
21 Sept 20263 days before the snapshot
Repository archived
No
Open issues
1,482
Open pull requests
340
Commits, last 52 weeks
2,408
Dependents on npm
1,999

Major versions

  1. v12 first release 12.0.0, 10 Sept 2026
  2. v11 first release 11.0.0, 23 Aug 2024
  3. v10 first release 10.0.0, 21 Feb 2023
  4. v9 first release 9.0.0, 7 Apr 2022
  5. v8 first release 8.0.0, 18 Dec 2018
  6. v7 first release 7.0.0, 29 Jan 2017
  7. v6 first release 6.0.0, 29 May 2016
  8. v0 first release 0.2.11, 2 Dec 2014

Recent releases

VersionPublished
12.0.010 Sept 2026
11.17.225 Aug 2026
11.17.124 Aug 2026
11.17.019 Aug 2026
10.9.84 Aug 2026
11.16.14 Aug 2026
11.16.025 Jun 2026
10.9.611 May 2026
11.15.011 May 2026
11.14.01 Apr 2026
11.13.09 Mar 2026
11.12.317 Feb 2026
11.12.22 Dec 2025
10.9.54 Nov 2025

Compatibility

Module format
ESM onlyFrom package.json type, main and exports fields
TypeScript types
Bundled
Node.js engine range
>=22.12.0
Runtimes
-
Unpacked size (npm)
118.8 MB
Dependencies (23)
d3uuiddayjselkjskatexkhromamarkedstylisroughjs@types/d3cytoscaped3-sankeydompurifyts-dedentchevrotaines-toolkitdagre-d3-es@iconify/utilscytoscape-fcose@upsetjs/venn.js@mermaid-js/parsercytoscape-cose-bilkent@braintree/sanitize-url

Install

npm install mermaid

CDN

jsDelivr: 262.3m requests in 30 days
  • jsDelivrhttps://cdn.jsdelivr.net/npm/mermaid@12.0.0/
  • unpkghttps://unpkg.com/mermaid@12.0.0/
  • esm.shhttps://esm.sh/mermaid@12.0.0
Sources: npm registry, npm downloads API, GitHub API, jsDelivr. Data fetched 25 Sept 2026.

Indexability: Indexed.