Mermaid Cli Diagram As Code Renderer

---
name: "Mermaid CLI Diagram-as-Code Renderer"
slug: "mermaid-cli-diagram-as-code-renderer"
description: "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."
github_stars: 4341
verification: "security_reviewed"
source: "https://github.com/mermaid-js/mermaid-cli"
author: "mermaid-js"
category: "Image & Creative Automation"
framework: "Multi-Framework"
tool_ecosystem:
  github_repo: "mermaid-js/mermaid-cli"
  github_stars: 4341
  npm_package: "@mermaid-js/mermaid-cli"
  npm_weekly_downloads: 438910
---

# 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/)