mermaid-js/mermaid-cli - thehardwarestore.ai

── AI DEEP ANALYSIS ──

reviewed by: nvidia/nemotron-3-super-120b-a12b

mermaid-cli is a command-line interface for generating diagrams from Mermaid syntax. It processes input files (.mmd, .md, .markdown) containing Mermaid diagram definitions and outputs SVG, PNG, or PDF files. The architecture centers around a Puppeteer-driven rendering pipeline that launches a headless browser to render Mermaid diagrams via the Mermaid library. Key features include Markdown diagram extraction, configurable theming, CSS injection, icon pack support, and programmable Node.js API. The CLI entry point is src/cli.js, which delegates to the run() and renderMermaid() functions in src/index.js for core functionality. External dependencies include Puppeteer, Mermaid, and various layout engines (ELK, tidy-tree).

── METRICS ──

RATING8.8/10

QUALITY8.5/10

MAINTENANCEactive

DRIFTlow

CONTRIBUTORS73

VELOCITY0.83

OPEN ISSUES85

CLOSED ISSUES161

LAST COMMIT1 month ago

── TAGS ──

#mermaid-cli #diagram-generation #commander-cli #puppeteer #svg-png-pdf #markdown-processing #diagrams #cli #mermaid

── GITHUB TOPICS ──

diagrams cli mermaid

── DEPENDENCY GRAPH ──

@fortawesome/fontawesome-free (npm) ^6.0.0 || ^7.0.1

@mermaid-js/layout-elk (npm) ^0.1.5 || ^0.2.0

@mermaid-js/mermaid-zenuml (npm) ^0.2.0

chalk (npm) ^5.0.1

commander (npm) ^13.1.0

import-meta-resolve (npm) ^4.1.0

katex (npm) ^0.16.25

mermaid (npm) ^11.14.0

p-limit (npm) ^6.2.0

@eslint/js (npm) ^9.0.0

@tsconfig/node18 (npm) ^18.2.4

@types/node (npm) ~18.19.31

cross-env (npm) ^7.0.3

eslint (npm) ^9.0.0

globals (npm) ^17.6.0

jest (npm) ^30.0.5

prettier (npm) ^3.8.3

puppeteer (npm) ^25.0.0

typescript (npm) ^6.0.3

typescript-eslint (npm) ^8.59.3

vite (npm) ^6.0.2

yarn-upgrade-all (npm) ^0.8.1

── FILE BREAKDOWN ──

Files by Type (count)

Other (.mmd)

27

Markdown

17

YAML

13

JavaScript

11

JSON

9

Other (no ext)

6

TypeScript

2

Shell

2

CSS

2

Git Ignore

1

Dockerfile

1

Other (.svg)

1

Files by Type (size)

JSON

348KB

Other (.svg)

198KB

JavaScript

90KB

Markdown

26KB

YAML

21KB

Other (.mmd)

6KB

Shell

4KB

Other (no ext)

2KB

CSS

911B

Dockerfile

591B

Other (.markdown)

383B

Git Ignore

379B

── KEY FINDINGS: REUSABLE CODE ──

The LLM identified 2 files worth highlighting for reuse:

Provides request interception to serve local files as HTTP resources in Puppeteer, enabling ES module loading without a local server. Demonstrates non-obvious skill in solving a common Puppeteer limitation through URL rewriting and file serving.

file: src/puppeteerIntercept.js ↗ | tags: #interceptor #puppeteer #esm-loading

Exports run() and renderMermaid() functions for programmatic Mermaid diagram rendering. Handles Markdown code block extraction, browser setup, dependency loading via interceptor, and output format conversion. Represents a clean separation of concerns between CLI and library concerns.

file: src/index.js ↗ | tags: #library-api #mermaid-rendering #markdown-processing

── HISTORY ──

Last analyzed: 2026-09-02 18:39:03.099674

Next check: 2026-09-09 18:39:03.093461

$ show mermaid-js/mermaid-cli