Conversor online gratuito de MMD para RST

Projetos que usam Sphinx, Docutils ou outro sistema de documentação baseado em reStructuredText exigem um arquivo .rst em vez de uma fonte MultiMarkdown. A conversão preserva títulos, listas, links, blocos de código e outras estruturas compatíveis em um formato de texto simples editável.

O que é o formato MMD

MMD geralmente significa MultiMarkdown, um formato Markdown estendido armazenado como um arquivo de texto simples .mmd. Ele adiciona recursos como metadados, tabelas, notas de rodapé, citações, listas de definições e referências cruzadas ao Markdown padrão.

Os arquivos MultiMarkdown são criados pelas ferramentas de linha de comando MultiMarkdown e por editores Markdown compatíveis com a sintaxe MultiMarkdown. Você pode encontrá-los em projetos de escrita, repositórios de documentação técnica e arquivos de origem preparados para conversão em HTML, PDF ou outros formatos de documento.

O que é o formato RST

RST, ou reStructuredText, é um formato de marcação estruturado de texto simples usado pelo Docutils, Sphinx, pela documentação Python e por geradores de documentação. Seus marcadores explícitos de seção, diretivas, roles, labels e field lists o tornam adequado para grandes projetos de documentação e builds automatizados.

RST é útil quando o sistema de destino espera arquivos que terminem em .rst, especialmente um projeto Sphinx. Ele também é compatível com admonitions, diretivas de API, referências internas, tabelas, blocos de código literal e campos de metadados, embora alguns recursos do MultiMarkdown exijam ajustes manuais após a conversão.

Como converter MMD em RST

Usando Pandoc

Pandoc é a opção mais prática para uma conversão estruturada em desktop ou pela linha de comando. Instale uma versão atual do Pandoc, abra um terminal na pasta que contém o arquivo de origem e execute:

pandoc input.mmd -f markdown_mmd -t rst -o output.rst

O reader markdown_mmd informa ao Pandoc que a fonte deve ser interpretada como MultiMarkdown, enquanto rst seleciona a saída em reStructuredText. Substitua input.mmd e output.rst pelos nomes de arquivo reais.

Para um documento que usa a sintaxe Markdown padrão em vez de extensões específicas do MultiMarkdown, esta alternativa geralmente é suficiente:

pandoc input.mmd -f markdown -t rst -o output.rst

Abra o arquivo resultante em um editor de texto, verifique os sublinhados de seção e as diretivas gerados e, em seguida, faça o build com Sphinx ou Docutils. Em um projeto Sphinx, coloque output.rst no diretório de origem da documentação e execute o comando de build normal do projeto.

Usando o conversor online

Você pode converter o arquivo gratuitamente no site 101convert.com sem instalar software: selecione o arquivo MMD, escolha RST como formato de saída, inicie a conversão e baixe o arquivo .rst gerado.

Limitações de qualidade e compatibilidade

• Os metadados do MultiMarkdown podem se tornar sintaxe de field list do RST, parágrafos comuns ou comentários do documento, dependendo do campo e da versão do Pandoc; verifique manualmente o título, autor, data e outros metadados.
• Títulos, ênfase, links, imagens, listas ordenadas, blocos de código delimitados e muitas tabelas geralmente são convertidos corretamente, mas o RST exige estilos de sublinhado de seção exclusivos e uma indentação mais rigorosa.
• Citações do MultiMarkdown, transclusion, atributos especiais e extensões personalizadas podem não ter um equivalente direto no RST. O Pandoc pode preservar material incompatível como texto bruto, mas não pode reproduzir comportamentos que o RST ou o builder de destino não implementa.
• Verifique os caminhos das imagens, os destinos dos links, as âncoras, as notas de rodapé e o escaping após a conversão. O Sphinx pode exigir labels explícitos, como .. _label:, e diretivas, como .. code-block:: python, para recursos que eram implícitos na fonte MMD.