Como converter RST para MD
- Adicione o seu arquivo .RST - arraste-o para a caixa acima ou clique para procurar.
- Converta-o para .MD em poucos segundos.
- Baixe o seu novo arquivo .MD.
O que esperar
- Títulos, listas de marcadores, links e código inline são convertidos de forma limpa; diretivas RST (
.. note::,.. code-block::) e funções (:ref:,:func:) são descartadas ou aproximadas - revise cada diretiva após a conversão. - Um
.. toctree::não é preservado; você deve reconstruir o índice manualmente após a conversão. - Para atingir uma variante específica de Markdown, passe
-t gfm(GitHub Flavored Markdown) ou-t commonmarkpara o Pandoc.
Perguntas frequentes
A conversão de RST para Markdown é lossless (sem perdas)?
Não. O conteúdo básico - títulos, listas, links, código inline - é transferido, mas diretivas e funções RST não têm equivalente em Markdown e são perdidas. A limpeza manual é normal.
Qual é a principal diferença entre RST e Markdown?
Ambas são linguagens de marcação de texto simples, mas o RST possui um sistema de diretivas e funções mais rico, projetado para documentação estruturada (Sphinx). O Markdown é mais simples e amplamente utilizado para READMEs e notas gerais.
Como converto uma pasta inteira de arquivos RST?
O Pandoc processa um arquivo por comando; no Linux ou macOS, use um loop com
for f in *.rst; do pandoc "$f" -o "${f%.rst}.md"; done.Como mantenho os documentos do Sphinx funcionando após a conversão para Markdown?
Use MyST Markdown em vez de Markdown comum - o MyST suporta diretivas e funções no estilo RST para que sua compilação do Sphinx continue funcionando.
