Conversor online gratuito de MMD para PNG

O que é o formato MMD

No contexto de mapas mentais e fluxogramas, .mmd é um arquivo de diagrama Mermaid em texto simples. Ele contém a sintaxe do Mermaid que descreve nós, conexões, rótulos, direções e tipos de diagrama, como fluxogramas, mapas mentais, diagramas de sequência e diagramas de classes.

Editores do Mermaid, sistemas de documentação, repositórios de código e fluxos de trabalho de criação de diagramas criam ou usam arquivos MMD. Um arquivo típico contém código-fonte como flowchart TD; A[Start] --> B[Finish], em vez de pixels pré-renderizados. O arquivo pode ser editado com qualquer editor de texto, mas requer um renderizador compatível com Mermaid para produzir uma imagem.

O que é o formato PNG

PNG é um formato de imagem raster compatível com navegadores da web, aplicativos de escritório, editores de imagens, softwares de apresentação e a maioria dos sistemas operacionais. Ele é adequado para diagramas porque usa compressão sem perdas, mantém bordas nítidas de cores sólidas e oferece suporte à transparência.

Use PNG quando o destino aceitar imagens, mas não renderizar a sintaxe do Mermaid, ou quando precisar de um instantâneo visual fixo para documentação, e-mails, apresentações ou arquivamento. PNG não é ideal para escalabilidade ilimitada; SVG geralmente é melhor quando o diagrama precisa permanecer nítido como vetor em qualquer tamanho.

Como converter MMD para PNG

Usando o conversor online integrado

Você pode converter o arquivo em 101convert.com gratuitamente, sem instalar software. Carregue o arquivo .mmd, selecione PNG como formato de saída, se solicitado, inicie a conversão e baixe a imagem renderizada. A origem deve conter sintaxe válida do Mermaid; um arquivo com texto não relacionado ou sintaxe sem suporte pode não ser renderizado.

Usando o Mermaid CLI

Mermaid CLI é o método mais direto para desktop ou linha de comando:

1. Instale o Node.js e, em seguida, instale o Mermaid CLI com npm install -g @mermaid-js/mermaid-cli.
2. Salve a origem do Mermaid em um arquivo como diagram.mmd.
3. Renderize-a com mmdc -i diagram.mmd -o diagram.png.

O comando lê a origem do Mermaid, renderiza-a por meio de um mecanismo de navegador e grava a saída PNG. As opções úteis incluem -b transparent para um plano de fundo transparente, -s 2 para um fator de escala de duas vezes, -w 2000 para uma largura-alvo e -H 1200 para uma altura-alvo. Por exemplo:

mmdc -i diagram.mmd -o diagram.png -b transparent -s 2

Em sistemas nos quais as dependências do Chromium não estão disponíveis, o Mermaid CLI pode exigir os pacotes do sistema operacional usados pelo mecanismo de navegador Puppeteer. Uma configuração de renderização pode ser fornecida com -p puppeteer-config.json.

Limitações de qualidade e compatibilidade

A saída PNG contém apenas a aparência renderizada; posições dos nós, links, rótulos e sintaxe do Mermaid não podem ser editados como objetos de diagrama. Mantenha o arquivo .mmd original junto com o PNG quando houver probabilidade de futuras edições.

A renderização pode variar entre versões do Mermaid porque a sintaxe dos diagramas, os temas padrão, as fontes e os algoritmos de layout mudam. Instale uma versão compatível do Mermaid CLI e verifique as fontes personalizadas na máquina de renderização. Aumente -s, -w ou -H quando os rótulos pequenos parecerem borrados, mas evite ampliar um PNG de baixa resolução após a conversão.