mermaid-js

    mermaid-js/mermaid-cli

    Command line tool for the Mermaid library

    cli
    diagrams
    mermaid
    JavaScript
    MIT
    5.1K stars
    394 forks
    5.1K GitHub watchers
    Updated Oct 27, 2026
    View on GitHub

    Build with Backblaze B2

    SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.

    Explore Backblaze Labs

    Loading star history...

    Where it stands

    Rank, growth pace and release cadence relative to everything GStars tracks.

    2 releases in the last 90 days, the latest 33 days ago, with 62 contributors on GitHub.

    Gained 38% fewer stars in the last 90 days than in the 90 days before.

    Use Cases & Benefits

    • Converts Mermaid diagram definition files into SVG, PNG, or PDF images via a command-line interface.
    • Enables automated, scriptable diagram generation without a graphical interface, supporting themes, custom CSS, and multiple output formats.
    • Use for generating static diagrams from Mermaid files in CI/CD pipelines to automate documentation updates.
    • Use for embedding Mermaid diagrams as images in markdown files by transforming markdown with inline Mermaid code.
    • Use for creating animated SVG diagrams with custom CSS for enhanced visual presentations or web content.

    Should you depend on it?

    License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.

    License

    MIT

    Permissive: commercial use, modification and redistribution are allowed with attribution.

    Community files

    • README: present
    • Contributing guide: present
    • Code of conduct: present

    Watch-outs

    No watch-outs from GStars' checks.

    General guidance from repository metadata, not legal advice. How we score

    From the README

    This is a command-line interface (CLI) for mermaid. It takes a mermaid definition file as input and generates an SVG/PNG/PDF file as output.

    Convert Mermaid mmd Diagram File To SVG

    Note

    See Alternative installations if you don't want to install the package globally.

    Locate how to call the mmdc executable for your preferred method i.e. Docker, Yarn, NPM, local install, etc.

    Excerpt from the mermaid-js/mermaid-cli README on GitHub (MIT license). © its authors.Read the full README on GitHub

    Daily snapshots

    Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots

    Forks

    394+14

    Open issues

    81-15

    Compared with peers in CLI

    Fastest-growing repositories GStars tracks in this cohort for the week of Nov 1, by 7-day star growth

    mermaid-js/mermaid-cli compared with CLI repositories by stars, 7-day star growth, health score and last release
    RepositoryStars+7dHealthLast release
    vercel-labs/agent-desktop17.0K+13.3K33today
    mattpocock/skills315.4K+8.7K357 days ago
    stablyai/orca116.8K+6.6K40today
    obra/superpowers313.1K+4.5K532 days ago
    Panniantong/Agent-Reach109.3K+3.0K604 days ago
    mermaid-js/mermaid-cli5.1K—6333 days ago
    Category median116.8K+6.6K40—

    Also by mermaid-js

    Other repositories from this maintainer that GStars tracks

    Discover Repositories

    Search across tracked repositories by name or description