Este conversor de Markdown para RST gera reStructuredText para Sphinx, Read the Docs e PyPI: títulos sublinhados, diretivas code-block, grid tables, admonitions e notas de rodapé. Cole um README.md e copie o .rst.
Última atualização:
Como funciona
Cole o Markdown
Cole um README ou uma página de documentação, use Abrir arquivo para um .md ou clique em Carregar exemplo.
Escolha as convenções
Defina os Sublinhados dos títulos, a diretiva de Blocos de código, o estilo de Tabelas e o de Links.
Use o .rst
Baixe o README.rst ou cole o texto no seu projeto Sphinx.
Recursos
Estrutura de seções válida
O RST deduz os níveis pela ordem dos estilos de sublinhado; níveis pulados no Markdown são compactados para evitar o erro “Title level inconsistent”.
Diretivas, sem gambiarras
Código vira .. code-block:: python, notas viram .. note:: ou .. warning::, e fórmulas .. math::.
Três estilos de tabela
Grid table, Simple table ou a Diretiva list-table, que é a mais fácil de editar depois.
Regras de marcação inline
Espaços escapados são inseridos onde o RST exige espaço em volta de **negrito** ou de `links`__.
Limites e privacidade
Limites e privacidade
Arquivos de até 10 MB. Entradas acima de 256 KB são convertidas em um Web Worker, e a página continua respondendo. Nada é enviado: a conversão acontece no seu navegador, e Abrir de URL baixa o arquivo diretamente do endereço informado. Saiba mais na página de privacidade.
Diferenças para ter em mente
O reStructuredText não tem tachado nem sublinhado: esse texto fica sem formatação. Quebras de linha forçadas viram line blocks (linhas com |). Uma transição (––) não pode abrir nem fechar um documento, e nesses pontos é removida. Grid tables e simple tables não têm alinhamento de colunas.
Perguntas frequentes
Como converter README.md em README.rst?
Abra o README.md aqui e baixe o resultado como README.rst. Confira os avisos sobre o que o RST não consegue representar.
O PyPI ainda exige RST?
Não, o PyPI também exibe Markdown. Mas projetos Sphinx e muitas ferramentas mais antigas esperam reStructuredText.
O Sphinx acusa “Title level inconsistent”. O que fazer?
Geralmente é um nível de título pulado no Markdown, como um ### logo depois de um #. Ao converter aqui, esses níveis são compactados e o erro não aparece.
Por que o negrito dentro de um link sumiu?
O reStructuredText não permite aninhar marcação inline. O texto do link é mantido e a formatação interna é descartada com um aviso.
Como ficam imagens no meio do texto?
Imagens inline usam substituições: |nome| no texto e uma definição .. |nome| image:: no final.
Dá para converter RST de volta para Markdown?
Sim, com RST → Markdown, que tem link acima do resultado.