Conversor online gratuito de MERMAID para PDF

PDF é usado quando um diagrama Mermaid precisa ser compartilhado com pessoas que não têm um editor Mermaid, impresso ou preservado em um layout fixo. Converter o diagrama de origem para PDF renderiza seu fluxograma ou mapa mental como um documento portátil, em vez de deixá-lo como código de diagrama editável.

O que é o formato MERMAID

Mermaid é um formato de diagrama baseado em texto usado para fluxogramas, mapas mentais, diagramas de sequência, diagramas entidade-relacionamento, linhas do tempo e documentação visual relacionada. Os arquivos geralmente usam .mmd ou .mermaid; o código Mermaid também pode aparecer dentro de blocos delimitados em arquivos Markdown.

Um arquivo Mermaid contém instruções de origem, como rótulos de nós, conexões, declarações de layout e estilos, em vez de uma imagem pronta. Mermaid Live Editor, Mermaid CLI, extensões do Visual Studio Code, Obsidian e sistemas de documentação Markdown podem criar ou renderizar esses diagramas.

O que é o formato PDF

PDF armazena o diagrama renderizado junto com as dimensões da página, fontes, cores e informações de layout. Ele é adequado para impressão, anexos de e-mail, documentação, relatórios técnicos e cópias de arquivo, pois os destinatários podem visualizá-lo com software PDF padrão sem instalar o Mermaid.

PDF normalmente é um formato de apresentação, não um formato de origem: editar o diagrama geralmente exige alterar o arquivo Mermaid original e exportar um novo PDF.

Como converter MERMAID para PDF

Usando o Mermaid CLI

1. Instale o Node.js, caso ele ainda não esteja instalado.
2. Instale o Mermaid CLI com npm install -g @mermaid-js/mermaid-cli.
3. Coloque o código-fonte do diagrama em um arquivo, como flowchart.mmd. Verifique se ele começa com uma sintaxe Mermaid válida, por exemplo, flowchart TD.
4. Execute mmdc -i flowchart.mmd -o flowchart.pdf.
5. Abra flowchart.pdf e verifique os rótulos, conectores, quebras de página e a renderização das fontes.

Para que um diagrama caiba em uma única página PDF, use mmdc -i flowchart.mmd -o flowchart.pdf --pdfFit. O comando usa o renderizador baseado em Chromium do Mermaid, portanto o PDF contém o diagrama renderizado, e não o código-fonte original.

Usando o 101convert.com

Você pode converter o arquivo no 101convert.com gratuitamente, sem instalar software. Envie o arquivo Mermaid, selecione PDF como formato de saída, inicie a conversão e baixe o documento resultante. Essa opção é útil quando Node.js e Mermaid CLI não estão disponíveis.

Usando um editor Mermaid

Abra o código-fonte em um editor compatível com a renderização Mermaid e use Export → PDF ou Print → Save as PDF do navegador. A impressão pelo navegador é uma alternativa; ela pode incluir margens de página, cabeçalhos, rodapés ou dimensionamento que não estão presentes em uma exportação direta do Mermaid CLI.

Considerações sobre qualidade e compatibilidade

Diagramas grandes podem ser reduzidos até que os rótulos se tornem difíceis de ler. Divida um código-fonte muito cheio em vários diagramas, aumente as dimensões da página por meio da configuração do Mermaid CLI ou exporte PDFs separados para diferentes seções.

A saída PDF depende da versão do Mermaid, do tema de renderização, das fontes instaladas e de quaisquer ícones ou recursos externos referenciados. Use a mesma versão do Mermaid CLI para obter exportações consistentes e escolha uma fonte comum ou incorpore as fontes necessárias por meio da configuração do renderizador quando o PDF for aberto em outros sistemas.

Recursos interativos, editabilidade do código-fonte e alguns estilos específicos do navegador não são transferidos para o PDF. Mantenha o arquivo .mmd original junto ao PDF quando houver probabilidade de futuras alterações.