1001Ferramentas
📰 Conversores

Conversor Markdown → reStructuredText

Conversor básico de Markdown para RST: títulos com sublinhado (=== ---), listas, link e código inline. Útil para Sphinx.

reStructuredText:

Markdown para reStructuredText

reStructuredText é o formato da documentação Python: Sphinx, Read the Docs e boa parte dos projetos da linguagem esperam arquivos .rst. Quem escreve em Markdown no dia a dia e precisa contribuir com um desses projetos acaba tendo que traduzir a marcação — e as diferenças começam logo no cabeçalho, que no RST não usa cerquilha e sim uma linha de símbolos embaixo do texto.

Cole o Markdown e a página devolve o equivalente em RST. Os três níveis de cabeçalho ganham sublinhado com igual, hífen e til, dimensionado pelo comprimento do título; itens de lista trocam o hífen pelo asterisco; ênfase forte vira asterisco duplo, que é o mesmo dos dois lados; e bloco de código cercado por crases vira o marcador de dois pontos duplos seguido de bloco indentado, que é como o RST representa código literal.

A conversão trabalha linha a linha e cobre o que aparece na maior parte de um README. Fica de fora o que exige entender o documento inteiro — tabela, nota de rodapé, referência cruzada, diretiva de Sphinx. Para arquivo grande, o resultado serve de primeira passada; para migração completa de projeto, a ferramenta usual é o Pandoc, que monta a árvore do documento antes de escrever.

Perguntas frequentes

Por que o sublinhado precisa acompanhar o tamanho do título?
Porque o RST exige que a linha de adorno tenha pelo menos o comprimento do texto acima. Se ela for mais curta, o Sphinx emite aviso e às vezes deixa de reconhecer o cabeçalho. A conversão gera o tamanho exato, e ao editar o título depois lembre de ajustar a linha embaixo.
Qual símbolo corresponde a qual nível?
O RST não fixa isso: o nível é definido pela ordem de aparição no documento. A convenção mais comum, adotada aqui, é igual para o primeiro nível, hífen para o segundo e til para o terceiro. O importante é ser consistente dentro do arquivo — trocar a ordem no meio confunde o gerador.
E o MyST, que aceita Markdown no Sphinx?
É uma alternativa real: o MyST estende o Markdown com a sintaxe de diretivas do RST, e projetos novos frequentemente o adotam para não obrigar quem contribui a aprender RST. Se o projeto de destino já usa MyST, converter pode ser desnecessário.

Ferramentas Relacionadas