Conversor online gratuito de MMD para SVG

Um diagrama Mermaid salvo como um arquivo .mmd pode precisar de conversão quando outro aplicativo aceita somente SVG para incorporação, impressão, edição ou publicação na web. O SVG preserva o diagrama como uma arte vetorial escalável, em vez de uma imagem rasterizada de tamanho fixo.

O que é o formato MMD

No contexto de mapas mentais e fluxogramas, .mmd é um arquivo de código-fonte de diagrama Mermaid em texto simples. Ele contém a sintaxe Mermaid para fluxogramas, diagramas de sequência, diagramas de classes, diagramas de estado, mapas mentais e estruturas visuais relacionadas; normalmente, ele não contém o gráfico renderizado propriamente dito.

Os arquivos Mermaid são criados em editores compatíveis com Mermaid, sistemas de documentação, projetos Markdown, repositórios de código e ferramentas de criação de diagramas que oferecem suporte ao Mermaid. Um arquivo pode conter declarações como flowchart TD ou mindmap, seguidas por nós, conexões, rótulos e instruções de estilo.

O que é o formato SVG

SVG é um formato de gráficos vetoriais baseado em XML compatível com navegadores da web, aplicativos de design, softwares de escritório, plataformas de documentação e muitos fluxos de trabalho de impressão. Ele armazena caminhos, formas, texto e estilos, em vez de uma grade de pixels, portanto um diagrama renderizado pode ser ampliado sem o desfoque associado a PNG ou JPEG.

Use SVG quando o destino precisar de um gráfico da web incorporável, uma ilustração escalável para documentação, uma arte vetorial editável ou um recurso de impressão de alta resolução. O resultado é um diagrama renderizado; normalmente, ele não é um arquivo-fonte que possa ser editado novamente na sintaxe Mermaid.

Como converter MMD para SVG

O método para desktop mais direto é o Mermaid CLI, cujo executável é mmdc. Instale o Node.js e, em seguida, instale o CLI em um terminal:

npm install -g @mermaid-js/mermaid-cli

Salve o código-fonte Mermaid como diagram.mmd e execute:

mmdc -i diagram.mmd -o diagram.svg

A opção de entrada seleciona o código-fonte MMD, e a opção de saída define o nome do arquivo SVG. Para usar um tema ou uma configuração de página personalizada, crie um arquivo de configuração JSON, como config.json, e execute:

mmdc -i diagram.mmd -o diagram.svg -c config.json

Você também pode converter o arquivo gratuitamente no 101convert.com, sem instalar software: escolha a conversão de MMD para SVG, carregue o arquivo .mmd, inicie a conversão e baixe o arquivo .svg resultante.

Qualidade e compatibilidade

A saída depende da versão do Mermaid usada pelo conversor. Sintaxe não compatível, recuo inválido em mapas mentais, declarações de diagrama ausentes ou recursos introduzidos em uma versão mais recente do Mermaid podem causar erros ou alterar o layout. Teste o código-fonte em uma visualização prévia do Mermaid antes da conversão.

O texto em SVG pode depender das fontes instaladas, portanto um diagrama pode ser reorganizado quando aberto em outro sistema. Para obter uma aparência consistente, use fontes comuns ou converta o texto em contornos em um editor vetorial após a renderização; a conversão em contornos remove a possibilidade de editar o texto e pode aumentar o tamanho do arquivo. O comportamento interativo do Mermaid e a possibilidade de editar o código-fonte geralmente não são preservados como SVG, e imagens externas ou recursos personalizados podem exigir tratamento separado.