Conversor de HTML para Markdown

O que é a conversão de HTML para Markdown?

HTML in:

  <h2>Pricing</h2>
  <p>Plans start at <strong>$9/mo</strong>. See the <a href="https://example.com/pricing">details</a>.</p>
  <table>
    <thead><tr><th>Plan</th><th>Price</th></tr></thead>
    <tbody><tr><td>Pro</td><td>$9</td></tr></tbody>
  </table>

Markdown out:

  ## Pricing

  Plans start at **$9/mo**. See the [details](https://example.com/pricing).

  | Plan | Price |
  | ---- | ----- |
  | Pro  | $9    |

  <!-- <div>, classes, and inline styles in the source are dropped — Markdown can't represent them. -->

Recursos Principais

Exemplos

<table>
  <thead><tr><th>Região</th><th>Vendas</th></tr></thead>
  <tbody>
    <tr><td>EMEA</td><td>1.204</td></tr>
    <tr><td>APAC</td><td>980</td></tr>
  </tbody>
</table>

| Região | Vendas |
| ------ | ------ |
| EMEA   | 1.204  |
| APAC   | 980    |

<p>Leia o <a href="https://example.com/guide">guia de configuração</a> e a <a href="https://example.com/api">referência da API</a>.</p>

Inline:
Leia o [guia de configuração](https://example.com/guide) e a [referência da API](https://example.com/api).

Referência:
Leia o [guia de configuração][1] e a [referência da API][2].

[1]: https://example.com/guide
[2]: https://example.com/api

<ul>
  <li>Build
    <ol>
      <li>Compilar</li>
      <li>Empacotar</li>
    </ol>
  </li>
  <li>Lançar</li>
</ul>

- Build
  1. Compilar
  2. Empacotar
- Lançar

<article>
  <h1>Changelog</h1>
  <p>Lançamos o <strong>modo escuro</strong> e corrigimos <code>parseDate()</code>.</p>
  <blockquote><p>Obrigado a todos que reportaram.</p></blockquote>
</article>

# Changelog

Lançamos o **modo escuro** e corrigimos `parseDate()`.

> Obrigado a todos que reportaram.

Como Converter HTML para Markdown

1. 1

   Cole o seu HTML

   Coloque uma página web copiada, uma exportação de CMS ou WYSIWYG, ou um trecho de HTML raspado. O DOM é analisado e serializado em Markdown no seu navegador conforme você cola — sem upload, sem limite de tamanho além da memória do seu navegador.

2. 2

   Escolha os estilos de cabeçalho e link

   Escolha cabeçalhos ATX (#) ou Setext (===) e links inline ou de referência. O Markdown re-renderiza ao vivo, então você pode comparar estilos instantaneamente. A saída mira no GitHub Flavored Markdown — tabelas, listas de tarefas e texto riscado incluídos.

3. 3

   Copie ou baixe

   Clique em Copiar para pegar o Markdown, ou Baixar para salvar um arquivo .md. Para ir na direção oposta, mude para a aba Markdown → HTML e cole o seu Markdown para obter HTML renderizado de volta.

Armadilhas Comuns

<div class="callout warning"><span style="color:red">Atenção!</span></div>
<!-- esperando que a caixa de destaque e a cor vermelha sobrevivam -->

Atenção!
<!-- contêiner e estilos descartados; só o texto permanece no Markdown -->

Linha um<br>Linha dois
<!-- se a forma de quebra for removida, elas se fundem numa linha -->

Linha um  
Linha dois
<!-- dois espaços finais preservam o <br> como quebra forte -->

<table><tr><td><table><tr><td>interno</td></tr></table></td></tr></table>
<!-- tabela aninhada não pode virar uma tabela com pipes plana -->

<!-- Achate para uma tabela de nível único primeiro: -->
<table><tr><td>interno</td></tr></table>
→ | interno |
  | ------- |

<style>.x{color:blue}</style>
<script>track()</script>
<p>Corpo</p>
<!-- esperando que o style e o script passem -->

Corpo
<!-- só o conteúdo sobrevive; <script>/<style> são descartados -->

Casos de Uso Comuns

Migrar conteúdo web ou de CMS para Notion, Obsidian ou um site estático

Tire páginas de um CMS, de uma exportação do WordPress ou de um site HTML antigo e converta-as para Markdown que cai direto no Notion, Obsidian, Hugo ou Jekyll. Você troca marcação verbosa por texto portável que vive de forma limpa num repositório Git e gera diffs sensatos em revisão.

Exportar de um editor WYSIWYG

Editores de texto rico emitem HTML denso e cheio de atributos. Cole essa saída aqui para recuperar o Markdown limpo por baixo — cabeçalhos, listas, links e ênfase — para que o conteúdo possa migrar para um pipeline de documentação ou uma base de conhecimento baseada em Markdown em vez de ficar preso no editor.

Limpar HTML em Markdown para alimentar LLMs e pipelines RAG

O HTML bruto queima tokens com tags, scripts e estilização que um modelo nunca precisa. Converter uma página raspada para Markdown elimina esse ruído enquanto mantém a estrutura que um LLM lê bem, então você encaixa mais conteúdo real na janela de contexto e obtém embeddings mais limpos para recuperação.

Converter um texto rico colado em Markdown

Copie texto formatado de uma página web, um e-mail ou um documento e ele chega como HTML na área de transferência. Cole-o aqui para transformar esse texto rico em Markdown que você pode commitar, enviar num pull request ou escrever nas suas notas — formatação preservada, bagunça eliminada.

Arquivar uma página como Markdown

Salve o conteúdo significativo de uma página web como um arquivo .md pequeno e à prova de futuro, em vez de um snapshot HTML pesado cheio de scripts e rastreamento. O Markdown permanece legível em qualquer editor de texto daqui a décadas e ocupa uma fração do espaço.

Transformar documentação HTML legada em Markdown

Documentação antiga escrita como HTML feito à mão é dolorosa de manter. Converta-a para Markdown para trazê-la a um fluxo de trabalho moderno de docs-as-code — onde ela pode ser passada por linter, revisada em pull requests e renderizada por um gerador de site estático.

Detalhes Técnicos

Saída CommonMark vs GitHub Flavored Markdown

O conversor pode mirar no CommonMark puro ou, por padrão, no superconjunto GitHub Flavored Markdown. O CommonMark define cabeçalhos, ênfase, listas, links, imagens, código e blockquotes com precisão. O GFM adiciona quatro construções que mapeiam diretamente de HTML comum: <table> → tabela com pipes, itens de lista com checkbox → listas de tarefas, <del>/<s> → texto riscado, e URLs nuas → autolinks. Como a maioria do conteúdo web usa tabelas e afins, a saída GFM é o padrão prático; escolha CommonMark apenas quando o renderizador de destino não entender as extensões GFM, caso em que tabelas caem para HTML bruto.

Conversão com Perdas e Irreversível — Dito Claramente

O HTML é estritamente mais expressivo do que o Markdown, então a conversão não pode ser sem perdas, e vale a pena ser franco sobre isso. O Markdown não tem sintaxe para <div>, <span> ou outros contêineres genéricos; nenhuma forma de carregar nomes de classe, id, style inline, colspan/rowspan ou atributos data-* arbitrários; e nenhuma representação para a maioria dos elementos semânticos ou de layout. Esses são desencapsulados (conteúdo mantido, tag descartada), descartados (atributos), ou — quando descartar perderia significado — preservados como HTML inline bruto. Uma ida e volta HTML → Markdown → HTML não reproduzirá o original. Essa é uma troca deliberada: o Markdown existe para ser limpo, comparável por diff e editável por humanos, não para espelhar o HTML. A maioria dos concorrentes ignora isso; declará-lo permite que você decida de olhos abertos se o Markdown é o destino certo.

Compromissos de Estilo: ATX/Setext, Inline/Referência, Cercado/Indentado

Três escolhas de saída têm compromissos reais. Cabeçalhos ATX (#) cobrem todos os seis níveis e fazem grep de forma limpa; Setext (sublinhado) só existe para H1/H2, então a ferramenta o emite para os dois níveis superiores e cai para ATX abaixo. Links inline mantêm a URL ao lado do texto — melhor para links esparsos; links de referência puxam as URLs para o pé do documento — melhor para prosa densa em links e reuso por rótulo. Para código, blocos cercados (três crases) carregam uma info string de linguagem e aninham com segurança, enquanto blocos de código indentados (quatro espaços) não conseguem expressar uma linguagem e quebram dentro de listas — então este conversor sempre emite blocos cercados a partir de <pre><code>.

Boas Práticas

Formate o HTML Antes de Converter

HTML minificado ou profundamente emaranhado — especialmente tabelas de layout aninhadas e elementos inline avulsos — converte de forma mais limpa quando está bem formado primeiro. Passe a fonte bagunçada pelo nosso Formatador HTML para fazer o pretty-print e normalizá-lo, depois converta. Entrada limpa rende Markdown limpo com menos quedas para HTML bruto.

Espere e Revise as Perdas

Trate a conversão como com perdas por design. Classes, estilos inline, invólucros <div>/<span> e atributos exóticos somem na saída, e isso geralmente é o que você quer para um Markdown portável — mas examine o resultado em busca de algo semanticamente importante que vivia apenas num atributo (um aria-label, uma célula mesclada por colspan) e adicione-o de volta à mão se importar.

Escolha o Estilo de Link pela Densidade do Documento

Use links inline para prosa com um link aqui e ali — a URL fica ao lado do seu texto e a fonte se lê naturalmente. Mude para links de referência quando uma seção tem muitos links ou reutiliza as mesmas URLs: puxá-las para uma lista numerada no pé mantém os parágrafos escaneáveis e evita repetir URLs longas.

Converta para Markdown Antes de Enviar Páginas a um LLM

Quando você alimenta conteúdo web a um modelo — para um prompt, um embedding ou um repositório RAG — converta o HTML para Markdown primeiro. Você elimina tags, scripts e estilização que desperdiçam tokens e adicionam ruído, mantém a estrutura que o modelo de fato usa e encaixa substancialmente mais conteúdo real dentro da janela de contexto.

Verifique Tabelas Complexas Após a Conversão

Tabelas com pipes GFM são planas — sem tabelas aninhadas, sem conteúdo de bloco em células, sem células mescladas. Após converter uma tabela densa em dados ou de layout, confira o Markdown: grades simples convertem perfeitamente, mas qualquer coisa com colspans ou blocos aninhados degrada e pode aparecer como HTML bruto. Simplifique a tabela de origem primeiro se uma tabela com pipes limpa importar.

Perguntas Frequentes