Tools/mermaid-js/mermaid

Mermaid

Generate diagrams from text

91.0k ★+96/wkestablishedTypeScriptMIT License →trending

The Lens

By Erik Loyd, SaaS CEO and former COO/CFO of an AWS Premier Partner.

Updated Oct 2026

Mermaid turns plain text into diagrams: flowcharts, sequence diagrams, ER diagrams, Gantt charts, plus newer types like architecture diagrams, kanban boards and Wardley maps. It's MIT, and GitHub, GitLab, Obsidian and Notion render it natively, so a code block in a README becomes a picture with no image file to keep in sync.

Cost to run: zero. Drop the library into a page, or do nothing when your platform already renders it. Version 12 (September 2026) made ELK the default layout engine, which re-lays out existing flowcharts; set layout: dagre to keep the old layout.

The paid side is Mermaid Chart at mermaid.ai, a hosted editor with AI credits, billed annually only. Plus is $10 per user per month, Premium $20, and SSO now lives in custom-priced Enterprise. Solo and small teams: free library, skip the editor. Larger teams pay only when non-technical people want a visual editor or SSO.

The catch: you steer the layout, you don't place nodes, so big diagrams need restructuring when the engine guesses wrong. For polished presentation work, Excalidraw wins. Rendering diagrams from untrusted users? Stay current: 2026 brought nine medium and low severity advisories.

Free vs Self-Hosted vs Paid

fully free

Free: The mermaid library, MIT licensed, current release 12.2.0 (2026-10-13). Every diagram type and the full renderer, no paywall. GitHub, GitLab, Obsidian, Notion and Azure DevOps render it natively, so many teams never install anything. The hosted editor's Basic plan is also free: the plan card says 3 diagrams while the comparison table says up to 6, with limited diagram size and 15 AI credits.

Self-hosted: Nothing to host. Add the npm package or a script tag, or write the code block and let your platform render it. Version 12.0.0 (2026-09-10) is a breaking release (ES2024, Safari 17.4+, Node 22.12+) that switches the default layout to ELK; pin your version if diagram output matters.

Paid: Mermaid Chart at mermaid.ai, annual billing only (monthly plans are not offered). Plus: $10 per user / month billed annually, unlimited diagrams and size, 300 AI credits per year. Premium: $20 per user / month billed annually, 2,000 AI credits per year, unlimited free viewer seats, unlimited teams and projects. Enterprise: custom pricing, adds SSO, custom contract and invoicing, IP management and a dedicated CSM. None of it is needed to use Mermaid syntax.

The library is MIT with zero paywalls. Mermaid Chart is an optional hosted editor billed annually only: Plus $10 and Premium $20 per user per month, with SSO only on custom-priced Enterprise.

What to do by team size

Solo
free; the library does everything, skip the hosted editor
Small team
free; standardize on Mermaid for diagrams that live in the repo
Medium team
free; Plus at $10/user/month billed annually only if non-technical teammates want the visual editor and AI
Large team
free library; Enterprise (custom pricing) only if you need SSO on the hosted editor
Self-hosting ops:trivial

Get tools like this every Wednesday

One featured tool, three on the radar. No fluff.

Similar Tools

Score
91/100 · A+
Adoption30/30
Maintenance25/25
Community11/20
License15/15
Analysis10/10

A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores

Trust Signals

High adoption: 87,423 starsActive community: 8,876 forksPermissive license (MIT)

About

Stars
91,024
Forks
9,457

Explore Further

More tools in the directory