Converter Markdown em reStructuredText

Gere uma fonte RST editável para uma migração. Funções, domínios, diretivas e referências específicas do Sphinx não podem ser deduzidas de um documento Markdown comum.

Entrada Markdown

243 caracteres

Prévia de RST

Texto convertido
Notas do projeto
================

Um documento claro começa com uma **estrutura bem definida**.

O que conferir
--------------

* Títulos fáceis de entender
* Links que continuam funcionando
* Arquivos simples de editar

    Confira a prévia renderizada antes de baixar.
Os arquivos são processados nesta aba do navegador.

Como usar Markdown para reStructuredText

Trabalhe primeiro com o documento Markdown; só considere a tarefa concluída depois de conferir código reStructuredText.

01

Adicionar a origem

Digite, cole ou abra o documento Markdown. O conteúdo continua disponível para correção durante a tarefa.

02

Revisar a estrutura

Revise a estrutura principal, confira os elementos que devem permanecer e corrija o que não fizer sentido antes de gerar o resultado.

03

Baixar .rst

Use a ação “Baixar .rst” e verifique código reStructuredText no programa ou no destino em que será usado.

O que a ferramenta entrega

código reStructuredText com uma etapa clara de revisão

Os pontos abaixo descrevem o que código reStructuredText mantém hoje. Eles não prometem reprodução idêntica entre formatos diferentes.

Estrutura principalSeções recebem títulos e sublinhados compatíveis.
Conteúdo reutilizávelListas e código mantêm a estrutura reconhecida.
Resultado verificávelLinks e tabelas simples viram fonte editável.
Quando usar

Três situações em que Markdown para reStructuredText ajuda

Uso no trabalho individual

Migrar um README para Sphinx.

Uso em colaboração

Preparar uma base de documentação Python.

Uso em migração ou publicação

Adaptar conteúdo a uma esteira docutils.

Perguntas frequentes

Dúvidas frequentes

O que é mantido em código reStructuredText?

Seções recebem títulos e sublinhados compatíveis. Listas e código mantêm a estrutura reconhecida. Links e tabelas simples viram fonte editável. Ainda assim, confira o resultado no destino final.

Por que código reStructuredText pode ficar diferente da origem?

Os formatos não têm os mesmos recursos. Diretivas e funções do Sphinx não são geradas automaticamente. Tabelas complexas podem precisar de reescrita.

Como revisar código reStructuredText antes de usar?

Rode o build com avisos no projeto de destino. Guarde a origem até terminar essa comparação.