# Mermaid CLI Diagram-as-Code Renderer

> Mermaid CLI (mmdc) is the command-line interface for the Mermaid diagramming library. It converts text-based diagram definitions into SVG, PNG, and PDF output files, enabling automated diagram generation from code.

- Skill: `agentskillexchange/mermaid-cli-diagram-as-code-renderer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/mermaid-cli-diagram-as-code-renderer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/mermaid-cli-diagram-as-code-renderer/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/mermaid-cli-diagram-as-code-renderer

---


# Mermaid CLI Diagram-as-Code Renderer

Mermaid CLI (mmdc) is the command-line interface for the Mermaid diagramming library. It converts text-based diagram definitions into SVG, PNG, and PDF output files, enabling automated diagram generation from code.

## Installation

Use the upstream install or setup path that matches your environment:
- npm install -g @mermaid-js/mermaid-cli
- ## Use Docker/Podman:
- docker pull minlag/mermaid-cli
- docker pull ghcr.io/mermaid-js/mermaid-cli/mermaid-cli

Requirements and caveats from upstream:
- [![node-lts (scoped)](https://img.shields.io/node/v-lts/@mermaid-js/mermaid-cli)](https://www.npmjs.com/package/@mermaid-js/mermaid-cli)
- [![Docker Image Version (latest semver)](https://img.shields.io/docker/v/minlag/mermaid-cli?label=Dockerhub)](https://hub.docker.com/r/minlag/mermaid-cli)
- [![Build, test and deploy mermaid-cli Docker image](https://github.com/mermaid-js/mermaid-cli/actions/workflows/compile-mermaid.yml/badge.svg)](https://github.com/mermaid-js/mermaid-cli/actions/workflows/compile-merma...

Basic usage or getting-started notes:
- sh
- Convert Mermaid mmd Diagram File To SVG
- mmdc -i input.mmd -o output.svg

- Source: https://github.com/mermaid-js/mermaid-cli
- Extracted from upstream docs: https://raw.githubusercontent.com/mermaid-js/mermaid-cli/HEAD/README.md

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/mermaid-cli-diagram-as-code-renderer/)