Skip to content
Projects

excalidraw/cli has 335 GitHub stars and 13 forks. GitHot measured +15 stars in 24 hours. Last checked 2026-11-18 21:05 UTC. Last push 2026-11-17.

How these counts are measured

What you can do

  • 🖼️ Render to PNG or SVG: any .excalidraw file, light or dark, transparent, up to 16× scale.
  • 🎞️ Export slides: each frame to its own image, in presentation order.
  • 🧜 Mermaid to Excalidraw: flowcharts, sequence, class, ER and state diagrams, Gantt charts, quadrant charts and timelines become editable shapes.
  • 🔒 Runs locally: uses the browser you already have. Nothing is uploaded, no account needed.

Measured star growth

in 24h
+15
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Official Excalidraw CLI for humans and agents

Developer Tools

README.md

Original

Excalidraw CLI: turn .excalidraw files and Mermaid diagrams into PNG, SVG, slides and Excalidraw+ scenes from your terminal

Documentation · npm · Excalidraw+ · Excalidraw

npm license

Render Excalidraw drawings and Mermaid diagrams from your terminal, free and without an account. With an Excalidraw+ API key, manage your workspace too.

Features

  • 🖼️ Render to PNG or SVG: any .excalidraw file, light or dark, transparent, up to 16× scale.
  • 🎞️ Export slides: each frame to its own image, in presentation order.
  • 🧜 Mermaid to Excalidraw: flowcharts, sequence, class, ER and state diagrams, Gantt charts, quadrant charts and timelines become editable shapes.
  • 🔒 Runs locally: uses the browser you already have. Nothing is uploaded, no account needed.
  • ☁️ Excalidraw+ workspace: scenes, collections, share links, presentations, members and audit logs.
  • 🤖 Made for scripts and AI agents: JSON output, stdin and stdout, and EXCALIDRAW_API_KEY.

Install

npm install -g @excalidraw/cli

Or run it without installing: npx @excalidraw/cli --help. Requires Node.js 22 or newer. excalidraw update updates it.

Quick start

# No account needed
excalidraw render drawing.excalidraw --out drawing.png
excalidraw render deck.excalidraw --all-frames --out slides/
excalidraw mermaid flow.mmd --out flow.excalidraw

# With Excalidraw+
excalidraw login
excalidraw scenes list --output table
excalidraw scenes render <sceneId> --out scene.png

Every command has --help with examples.

Documentation

📚 plus.excalidraw.com/docs/cli

The same guides are in docs/.

Contributing

See CONTRIBUTING.md for building the CLI and running the tests.

License

MIT