O Conversor HTML para Markdown transforma HTML em Markdown e Markdown em HTML, e detecta sozinho o formato do texto colado. O texto e a estrutura passam de um formato ao outro, como num adaptador de tomada; o que o destino não tem, como iframe, vídeo e SVG, fica de fora. Converter à mão é o caminho mais curto para o erro: um colchete ou um asterisco escapa e o link quebra. Cole o conteúdo inteiro, confira o preview e revise os trechos que a conversão descarta ou altera. Para imagens com caminho relativo, informe a base URL antes.
Como usar o Conversor HTML para Markdown
Cole o HTML ou o Markdown na entrada; a ferramenta mostra o formato detectado e para qual está convertendo. Nas opções, escolha se quer preservar estilos inline e atributos data-* (só valem para tags sem equivalente em Markdown, como mark e abbr) e informe a base URL das imagens. O Conversor HTML para Markdown exibe a saída e um preview; copie o texto ou baixe o arquivo.
O que muda em cada direção
De HTML para Markdown, títulos, parágrafos, listas, links, imagens, citações, código, negrito e itálico viram a sintaxe equivalente, e tabelas viram tabelas com barras verticais, com a primeira linha como cabeçalho. Sublinhado, subscrito e sobrescrito continuam como tags HTML, porque o Markdown não tem marcação própria para eles. Scripts, estilos, iframes, vídeos, áudios, SVG e campos de formulário são descartados; de um formulário sobra só o texto de botões e rótulos.
De Markdown para HTML, a conversão usa a biblioteca marked no modo GitHub Flavored Markdown, descrito na especificação do GitHub Flavored Markdown, com uma opção ligada que pega muita gente: cada quebra de linha simples vira <br>. Se o texto veio de um editor que quebra linhas no meio do parágrafo, junte as linhas antes de converter.
Cuidados antes de publicar o resultado
- A base URL só entra em caminhos relativos como
img/foto.png; caminhos que começam com barra ficam como estão. - O HTML gerado a partir de Markdown não passa por limpeza: HTML embutido no Markdown segue para a saída. Só o preview é higienizado.
- Tabelas saem sem alinhamento de colunas e sem células mescladas.
Onde a conversão ajuda
Levar um artigo do sistema de gerenciamento de conteúdo (CMS) para um repositório de documentação, montar um README a partir de uma página antiga ou limpar o HTML de um texto antes de colar num assistente de IA são usos comuns. O Conversor HTML para Markdown não conhece o seu CMS: shortcodes aparecem como texto comum e as classes dos blocos de construtores de página se perdem. Converta uma página de teste, publique como rascunho e compare com o original antes de migrar o resto.
Como conferir o resultado
Faça uma conversão pequena antes de colar um artigo inteiro. Por exemplo, <h2>Título</h2><p>Veja <strong>3 passos</strong>.</p> deve resultar em um título, um parágrafo e um trecho em negrito. Se o preview mostrar algo a mais, procure uma tag que veio aberta ou um caractere especial sem escape.
Depois, compare três pontos: a ordem dos blocos, os destinos dos links e as imagens. Em uma imagem com img/logo.png e base URL https://exemplo.com/imagens/, o endereço resultante combina a base com o caminho relativo. Já /img/logo.png começa na raiz e não recebe essa base. Essa checagem evita publicar uma imagem apontando para o endereço do ambiente de teste.
Erros comuns e limites
- Colar o texto renderizado do navegador quando a intenção era obter Markdown. O texto copiado da tela já perdeu a estrutura da página, e a conversão não tem como recuperá-la.
- Tratar o preview como prova de que o HTML está pronto para qualquer site. O preview é higienizado, mas a saída HTML preserva HTML embutido; revise scripts, atributos e links antes de publicar.
- Esperar que uma tabela complexa sobreviva sem revisão. A conversão não mantém alinhamento nem células mescladas, então reorganize a tabela ou mantenha essa parte em HTML.
Use a saída como base revisável e abra o resultado no editor de destino, sobretudo quando o conteúdo depende de shortcodes, classes de construtor ou componentes interativos sem equivalente em Markdown. Ao terminar, use o botão Limpar em computador compartilhado, já que a página mantém o texto neste navegador.