ariel-rs-cli

arielc — a fast Mermaid diagram CLI. Renders .mmd files to SVG without Node.js, Puppeteer, or a browser. Compatible with mmdc flags.

Install

Pre-built binaries (no Rust required) — download from GitHub Releases:

Platform	File
Linux x86_64	arielc-linux-x86_64.tar.gz
macOS Intel	arielc-macos-x86_64.tar.gz
macOS Apple Silicon	arielc-macos-arm64.tar.gz
Windows x86_64	arielc-windows-x86_64.zip

Via Cargo:

cargo install ariel-rs-cli

Usage

arielc -i diagram.mmd -o output.svg
arielc -i diagram.mmd -o output.svg --theme dark
cat diagram.mmd | arielc -i - -o output.svg
arielc -i diagram.mmd -o -          # stdout

Flags

Flag	Description	Default
-i, --input <FILE>	Input .mmd file (use - for stdin)	required
-o, --output <FILE>	Output .svg file (use - for stdout)	required
-t, --theme <NAME>	Theme: default, dark, forest, neutral	default
-b, --background-color <COLOR>	Background colour (e.g. transparent, #ffffff)	—
--quiet	Suppress progress output	false
--version	Print version and exit	—

mmdc compatibility

arielc is command-line compatible with mmdc for SVG output. To use it as a drop-in in scripts:

alias mmdc=arielc

Flags not applicable to arielc (no Puppeteer, no browser):

• -e, --puppeteerConfigFile — ignored
• -p, --puppeteerConfig — ignored
• -w, --width / -H, --height — SVG is resolution-independent (planned for PNG output)

Supported diagram types

All 28 diagram types supported by ariel-rs.

License

MIT © 2026 Rochanglien Infimate