Como converter um diagrama Mermaid em PDF?

Coloque o diagrama em um bloco de código marcado como mermaid, cole no MDPress e pressione o botão de PDF. O diagrama pode ser o documento inteiro ou apenas uma parte de um arquivo Markdown maior. Os dois casos funcionam do mesmo jeito.

Quais tipos de diagrama Mermaid são suportados?

O MDPress executa a biblioteca Mermaid padrão no seu navegador, então fluxogramas, diagramas de sequência, diagramas de classes, diagramas de estado, gráficos de Gantt e os demais tipos nativos são desenhados. Se um diagrama aparece na pré-visualização, ele estará no PDF.

É grátis, e meu diagrama fica armazenado?

Você tem quatro PDFs grátis a cada 24 horas sem conta e cinco com uma conta gratuita. Seu texto é enviado ao servidor uma vez para montar o PDF e não é guardado. O rascunho em si fica no seu navegador.

Mermaid para PDF

Converta um diagrama Mermaid em PDF, com o Markdown ao redor

Escreva seu fluxograma, diagrama de sequência ou gráfico de Gantt em um bloco de código mermaid e o MDPress o desenha. O diagrama aparece na pré-visualização ao vivo e entra no PDF como arte vetorial, então as linhas ficam nítidas em qualquer zoom. Sem instalação, sem linha de comando e sem conta para os primeiros quatro PDFs do seu dia.

Abrir o conversor

Do bloco mermaid ao PDF em três passos

01
Cole seu Markdown
Cole o documento no editor ou envie um arquivo .md. Mantenha cada diagrama em um bloco de código que comece com três crases e a palavra mermaid, do mesmo jeito que o GitHub espera.
02
Verifique o diagrama na pré-visualização
A pré-visualização desenha cada diagrama enquanto você digita. Se a sintaxe tiver um erro, o bloco aparece como código simples, então você consegue localizar a linha quebrada e corrigi-la antes de exportar.
03
Escolha um estilo e baixe
Escolha Limpo, Editorial ou Técnico, depois A4, A5 ou US Letter. Pressione o botão de PDF e o arquivo é baixado com seus diagramas incorporados e o texto ao redor selecionável.

Um arquivo Markdown com um fluxograma Mermaid

Esta breve nota de processo traz um fluxograma entre dois trechos de Markdown comum.

# Processo de lançamento

Toda mudança segue o mesmo caminho, da revisão até a produção.

```mermaid
flowchart LR
  A[Abrir pull request] --> B[Revisão de código]
  B --> C[Executar testes]
  C --> D[Implantar em staging]
  D --> E[Lançamento]
```

## Notas

- As revisões precisam de uma aprovação.
- Os testes rodam em cada push.
- O staging usa as mesmas configurações da produção.

Processo de lançamento

Toda mudança segue o mesmo caminho, da revisão até a produção.

flowchart LR
  A[Abrir pull request] --> B[Revisão de código]
  B --> C[Executar testes]
  C --> D[Implantar em staging]
  D --> E[Lançamento]

Notas

As revisões precisam de uma aprovação.
Os testes rodam em cada push.
O staging usa as mesmas configurações da produção.

Por que converter diagramas Mermaid aqui

Vetor, não uma captura de tela

Cada diagrama entra no PDF como arte vetorial, não como uma imagem bitmap. Dê zoom em um fluxograma denso ou imprima em papel e as linhas e os rótulos permanecem nítidos.

Diagrama e documento juntos

A maioria das ferramentas de Mermaid exporta uma única imagem. Aqui o diagrama fica dentro do documento inteiro, ao lado dos seus títulos, tabelas e código com realce, então uma especificação ou nota de design sai como um único arquivo.

Diagramas mantidos inteiros

Um diagrama é reduzido para caber na largura da página, e o layout evita dividi-lo entre duas páginas. Se um ficar mal posicionado, coloque uma linha \newpage acima dele para começar uma página nova.

Dicas para diagramas limpos

Mantenha os rótulos dos nós curtos e simples. Rótulos longos criam um diagrama largo, e um diagrama largo é reduzido para caber na página, o que encolhe o texto.
Diagramas grandes ficam melhores em A4 ou US Letter do que em A5. Para uma longa sequência de passos, tente um fluxograma de cima para baixo, para usar a altura da página.
Se um bloco aparecer como código na pré-visualização, a sintaxe Mermaid tem um erro. O PDF mostrará o mesmo bloco de código, então corrija antes de baixar.

Perguntas sobre Mermaid para PDF

Como converter um diagrama Mermaid em PDF?: Coloque o diagrama em um bloco de código marcado como mermaid, cole no MDPress e pressione o botão de PDF. O diagrama pode ser o documento inteiro ou apenas uma parte de um arquivo Markdown maior. Os dois casos funcionam do mesmo jeito.
Quais tipos de diagrama Mermaid são suportados?: O MDPress executa a biblioteca Mermaid padrão no seu navegador, então fluxogramas, diagramas de sequência, diagramas de classes, diagramas de estado, gráficos de Gantt e os demais tipos nativos são desenhados. Se um diagrama aparece na pré-visualização, ele estará no PDF.
É grátis, e meu diagrama fica armazenado?: Você tem quatro PDFs grátis a cada 24 horas sem conta e cinco com uma conta gratuita. Seu texto é enviado ao servidor uma vez para montar o PDF e não é guardado. O rascunho em si fica no seu navegador.

Transforme seu Markdown com Mermaid em PDF

Cole um documento com um bloco mermaid e veja o diagrama aparecer na pré-visualização.