Ir para o conteúdo

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.

  1. Abra o HTML para Markdown e cole o HTML no campo de entrada, à esquerda.
  2. Confira o Markdown gerado à direita, e o relatório de conversão logo abaixo dos dois painéis.
  3. 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.
  4. 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.

Perguntas frequentes