Como converter HTML para Markdown sem perder formatação
Copiar conteúdo de uma página web e colar num README, num CMS que aceita Markdown, ou num editor de notas — o problema é sempre o mesmo: o HTML de origem carrega tags, atributos e estrutura que o Markdown, deliberadamente mais simples, não sabe representar. A pergunta não é "dá para converter sem perder nada" (não dá — nenhuma ferramenta consegue isso, porque Markdown é um subconjunto menor), e sim "o que exatamente se perde, e a ferramenta te avisa disso, ou esconde?".
Passo a passo pelo Portal Tools
O HTML para Markdown do Portal Tools converte ao vivo, lado a lado, e mostra um relatório honesto do que não sobreviveu à conversão — em vez de simplesmente descartar o que não sabe representar.
- Abra o HTML para Markdown e cole o HTML no campo de entrada, à esquerda.
- Confira o Markdown gerado à direita, e o relatório de conversão logo abaixo dos dois painéis.
- Escolha a política para tags sem equivalente direto: descartar (mantém só o texto) ou preservar como HTML inline dentro do Markdown gerado — útil quando o destino final aceita HTML misturado ao Markdown, caso de GitHub e GitLab.
- Copie ou baixe o resultado.
O que tipicamente se perde na conversão
Três categorias diferentes de perda, e vale a pena distinguir entre elas:
- Estrutura sem equivalente —
<div>,<span>,<iframe>,<video>,<details>e outras tags não têm sintaxe Markdown correspondente. O texto de dentro sobrevive; a marcação em si, não — a menos que você escolha preservar como HTML inline. - Estilo e atributos — cor de texto, classes CSS, atributos
data-*customizados não têm representação em Markdown, que descreve estrutura de conteúdo (título, ênfase, lista), não aparência visual. - Conteúdo removido por segurança —
<script>, atributos de evento inline (onclick,onerror) e links com esquema não seguro nunca deveriam sobreviver a uma conversão, e o relatório deve dizer exatamente isso — nunca remover em silêncio um conteúdo que parecia inofensivo.
A diferença entre uma ferramenta confiável e uma que engana por omissão não é perder menos — é mostrar exatamente o que foi perdido e por quê.
Precisa do caminho inverso?
Se você já tem Markdown e precisa do HTML correspondente — para colar numa página, um CMS ou um e-mail — o Markdown para HTML do Portal Tools faz essa conversão com o mesmo cuidado de sanitização.