1001Ferramentas
🔨 Conversores

Conversor reStructuredText → HTML (Básico)

Renderiza RST simples em HTML: títulos sublinhados, listas, *itálico*, **negrito** e blocos de código indentados.

HTML gerado:

Preview:

reStructuredText para HTML

No RST, o cabeçalho não tem marcador próprio: ele é reconhecido pela linha de símbolos logo abaixo do texto. Isso torna a conversão para HTML menos óbvia do que parece — é preciso olhar a linha seguinte antes de decidir o que a atual é. Esta página faz esse trabalho e devolve o HTML correspondente, com pré-visualização.

O nível do cabeçalho sai do símbolo usado no adorno, seguindo a convenção mais comum: igual para o primeiro, hífen para o segundo e til para o terceiro. Lista com asterisco vira lista não ordenada, e o texto do conteúdo é escapado antes de entrar no HTML, de modo que sinal de menor no meio de um parágrafo aparece como caractere e não como marcação.

Vale saber o que fica de fora, porque no RST é bastante: diretivas, papéis de texto, referência cruzada, nota de rodapé e tabela dependem de interpretar o documento inteiro e de conhecer as extensões em uso. Para converter documentação completa, a ferramenta é o Docutils ou o Sphinx. Esta página resolve o caso de aproveitar um trecho em outro lugar.

Perguntas frequentes

Como o RST sabe qual nível é qual?
Pela ordem de aparição no documento: o primeiro símbolo de adorno encontrado define o nível um, o segundo símbolo diferente define o nível dois, e assim por diante. Não há símbolo reservado. A convenção adotada aqui é a mais comum na prática, mas um documento que use outra ordem sai com níveis trocados.
Por que meu cabeçalho não foi reconhecido?
Quase sempre porque a linha de adorno é mais curta que o texto. O RST exige que ela tenha pelo menos o mesmo comprimento; mais longa é aceito, mais curta não. É o erro que aparece depois de editar um título sem ajustar a linha de baixo.
E as diretivas do Sphinx?
Não são convertidas. Elas dependem de extensões carregadas na configuração do projeto, e cada uma gera HTML próprio — a de nota, a de código com destaque, a de índice. Fora do Sphinx não há como saber o que cada diretiva deveria produzir.

Ferramentas Relacionadas