Crafter Station Docs
Guias

Renderize um diagrama Mermaid pela CLI

Renderize diagramas Mermaid direto no seu terminal com um único comando npx. Sem navegador headless, sem baixar o Chromium, zero dependências.

npx @crafter/mermaid-cli diagram.mmd

Isso renderiza o diagrama no seu terminal com cores ANSI e caixas Unicode. Sem navegador headless, sem baixar o Chromium: o motor inteiro tem 30.5KB.

Pelo stdin

echo "graph TD; A-->B-->C" | npx @crafter/mermaid-cli

Escolha um tema

npx @crafter/mermaid-cli --theme tokyo-night diagram.mmd
npx @crafter/mermaid-cli --list-themes   # 30 available

Opções

FlagDescrição
--theme <name>Nome do tema (padrão: one-hunter)
--width <n>Largura do terminal (padrão: detecção automática)
--compactEspaçamento compacto
--list-themesLista todos os 30 temas

Instale de forma permanente

npm install -g @crafter/mermaid-cli
crafter-mermaid diagram.mmd

Qual a diferença para o @mermaid-js/mermaid-cli?

O @mermaid-js/mermaid-cli oficial renderiza abrindo um Chromium headless via Puppeteer, uma instalação pesada que não funciona em muitos ambientes de CI ou sandbox. O @crafter/mermaid-cli usa o @crafter/mermaid, um motor de renderização escrito do zero, com zero dependências e uma API síncrona, então roda em qualquer lugar onde o Node roda, na hora.

Precisa de saída SVG em vez de renderização no terminal? Use a biblioteca diretamente:

import { render } from "@crafter/mermaid"
const svg = render("graph TD; A-->B")

Nesta página