Adicionar a origem
Digite, cole ou abra o documento Markdown. O conteúdo continua disponível para correção durante a tarefa.
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.
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.
Trabalhe primeiro com o documento Markdown; só considere a tarefa concluída depois de conferir código reStructuredText.
Digite, cole ou abra o documento Markdown. O conteúdo continua disponível para correção durante a tarefa.
Revise a estrutura principal, confira os elementos que devem permanecer e corrija o que não fizer sentido antes de gerar o resultado.
Use a ação “Baixar .rst” e verifique código reStructuredText no programa ou no destino em que será usado.
Os pontos abaixo descrevem o que código reStructuredText mantém hoje. Eles não prometem reprodução idêntica entre formatos diferentes.
Migrar um README para Sphinx.
Preparar uma base de documentação Python.
Adaptar conteúdo a uma esteira docutils.
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.
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.
Rode o build com avisos no projeto de destino. Guarde a origem até terminar essa comparação.