# Mermaid

JavaScript diagramming and charting tool that renders diagrams from Markdown-inspired text definitions.


Source: https://findsoftware.frbit.cloud/mermaid/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- home: https://mermaid.ai/open-source/
- repository: https://github.com/mermaid-js/mermaid
- docs: https://mermaid.ai/open-source/intro/
- plugins: https://mermaid.ai/open-source/ecosystem/integrations-community.html
- x: https://twitter.com/mermaidjs_
- discord: https://discord.gg/sKeNQX4Wtj

### Identity

- status: active
- maintainer: Knut Sveidqvist
- maintainerType: unknown
- parent: unknown
- firstRelease: 2014
- hqCountry: unknown

### Kind

- category: graphics
- hosting: not applicable
- language: javascript
- runtime: unknown
- runtimeMin: not applicable
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: browser
- renderingModes: not applicable
- installMethod: npm, cdn

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 12
- latestReleaseDate: 2026-11-03

### Adoption

- githubStargazers: 91119
- packagistDownloads: not applicable
- npmWeeklyDownloads: 25860923
- contributors: 364
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 13441
- dependentPackages: 554

### Sources

- urls: https://mermaid.ai/open-source/ (read 2026-11-16)
- urls: https://api.github.com/repos/mermaid-js/mermaid (read 2026-11-16)
- urls: https://mermaid.ai/open-source/intro/ (read 2026-11-16)
- maintainer: https://github.com/mermaid-js/mermaid/blob/develop/LICENSE (read 2026-11-16)
- firstRelease: https://api.github.com/repos/mermaid-js/mermaid/commits/0.1.0 (read 2026-11-16)
- category: https://github.com/mermaid-js/mermaid/blob/develop/README.md (read 2026-11-16)
- language: https://api.github.com/repos/mermaid-js/mermaid (read 2026-11-16)
- runsAs: https://mermaid.ai/open-source/config/usage.html (read 2026-11-16)
- license: https://api.github.com/repos/mermaid-js/mermaid (read 2026-11-16)
- license: https://github.com/mermaid-js/mermaid/blob/develop/LICENSE (read 2026-11-16)
- licenseModel: https://github.com/mermaid-js/mermaid/blob/develop/LICENSE (read 2026-11-16)
- installMethod: https://mermaid.ai/open-source/intro/ (read 2026-11-16)
- installMethod: https://mermaid.ai/open-source/intro/ (read 2026-11-16)
- currentMajor: https://api.github.com/repos/mermaid-js/mermaid/releases/tags/mermaid@12.3.0 (read 2026-11-16)
- latestReleaseDate: https://api.github.com/repos/mermaid-js/mermaid/releases/tags/mermaid@12.3.0 (read 2026-11-16)
- githubStargazers: https://api.github.com/repos/mermaid-js/mermaid (read 2026-11-16)
- contributors: https://api.github.com/repos/mermaid-js/mermaid/contributors?per_page=1&anon=false (read 2026-11-16)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/mermaid (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/mermaid (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/mermaid (read 2026-11-16)
- urls: https://mermaid.ai/open-source/intro/ (read 2026-11-16)

## Notes

Mermaid is a JavaScript diagramming and charting tool. Diagrams are written as text in a Markdown-inspired syntax and rendered by the library in the page. The README shows flowchart, sequence, Gantt, class, state and pie diagrams, among others, each with a text example. A web page loads Mermaid from a CDN with a script tag, or an application installs it from npm.

## Worth knowing

The README warns that diagram text taken from outside users can carry scripts that run when the diagram is shown. For sites with external users it describes a sandboxed rendering level that blocks script in diagrams, at the cost of some interactive functionality.

The live editor and the command line interface are separate projects.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
