Ir para o conteúdo

Conversor de HTML para Markdown

Cole HTML e obtenha Markdown que mantém a estrutura: títulos, negrito e itálico, links, imagens, listas, citações, blocos de código e tabelas simples. Scripts, estilos e invólucros de layout são descartados, e a página mostra o quanto o resultado ficou menor. Gratuito, sem cadastro, e o HTML é analisado no seu navegador, nunca enviado.

Como usar o conversor de HTML para Markdown

  1. 1. Cole seu HTML. Um trecho ou uma página inteira funcionam; apenas o corpo é convertido.
  2. 2. Clique em Converter para Markdown. O Markdown aparece abaixo com três contadores: caracteres HTML, caracteres Markdown e a redução de tamanho.
  3. 3. Confira o resultado. Compare-o com o original, principalmente tabelas e listas aninhadas (veja os limites abaixo).
  4. 4. Copie. Copiar Markdown coloca o texto na sua área de transferência, pronto para um README, um gerador de sites estáticos ou um aplicativo de anotações.

O que cada elemento HTML vira

A ferramenta analisa seu HTML com o analisador do próprio navegador e percorre a árvore, então a marcação malformada é reparada do mesmo jeito que um navegador a repararia. Cada elemento então corresponde ao seu equivalente em Markdown:

HTMLMarkdown
h1 a h6# a ###### seguido do texto do título
pUm parágrafo separado por linhas em branco
br, hrUma quebra de linha; ---
strong, b**negrito**
em, i*itálico*
codeO texto entre crases simples
preUm bloco delimitado por três crases, sem rótulo de linguagem
aUm link: [text](address), com o texto entre colchetes e o endereço entre parênteses
imgUma imagem: ![alt](source), com o texto alternativo entre colchetes, um ponto de exclamação antes e a origem entre parênteses
ul, olMarcadores -, ou 1. 2. 3. renumerados a partir de 1; sublistas recuadas em dois espaços por nível
blockquoteCada linha precedida de >
tableUma tabela com barras verticais; a primeira linha vira o cabeçalho
div, span, section, qualquer outroDesembrulhado: a tag sai, o conteúdo permanece
script, style, head, meta, link, title, noscript, template, iframeRemovidos junto com o conteúdo

Exemplo prático

HTML

<h1>Citation Basics</h1><p>Use <strong>APA</strong> or <em>MLA</em>; see the <a href="https://apastyle.apa.org">APA site</a>.</p><ul><li>Author</li><li>Year<ul><li>Month</li></ul></li></ul><table><tr><th>Style</th><th>Year</th></tr><tr><td>APA</td><td>7th</td></tr></table>

Markdown

Um título # Citation Basics; um parágrafo com Use **APA** or *MLA*; see the [APA site](https://apastyle.apa.org).; a lista - Author, - Year e um - Month recuado; depois uma tabela de barras verticais com duas colunas, separadores --- e uma linha, APA e 7th.

Contadores

273 caracteres HTML, 159 caracteres Markdown, redução de 42%.

Markdown não expressa tudo o que o HTML expressa, e isso é justamente o objetivo: a saída é a estrutura do documento, e nenhuma de sua apresentação.

Limites a verificar

  • Tabelas são achatadas. Cada célula é reduzida ao seu texto simples, então links e ênfases dentro das células se perdem, as barras verticais são escapadas e células mescladas não são compreendidas. Tabelas com barras verticais são uma extensão do GitHub Flavored Markdown, não parte do CommonMark básico, então confira se o seu destino as suporta.
  • Algumas tags inline são descartadas. Sublinhado, tachado, sobrescrito e subscrito não têm equivalente em Markdown aqui, então o texto é mantido sem formatação.
  • Caracteres especiais não são escapados. Um asterisco ou sublinhado literal no seu texto é deixado como está e pode ser lido como ênfase por um renderizador de Markdown.
  • Listas numeradas aninhadas são recuadas em dois espaços por nível, o que a maioria dos renderizadores aceita, mas alguns exigem três sob um marcador 1..
  • Links e imagens mantêm seus endereços originais, então caminhos relativos continuam relativos.

Qual ferramenta você precisa?

Use esta página para manter a estrutura ao passar de HTML para Markdown. Se você quer apenas as palavras, o Removedor de tags HTML gera texto simples. No sentido inverso, o Conversor de Markdown para HTML renderiza Markdown, e o Markdown para texto reduz o Markdown a texto simples. Para organizar o HTML antes de converter, use o Formatador de HTML.

Perguntas frequentes

Quais elementos HTML são convertidos para Markdown?
Títulos, parágrafos, quebras de linha, linhas horizontais, negrito, itálico, código em linha, blocos de código, links, imagens, listas ordenadas e não ordenadas, citações em bloco e tabelas simples. A tabela acima lista o mapeamento exato.
Ela trata listas aninhadas?
Sim. Sublistas são recuadas em dois espaços por nível, e listas ordenadas são renumeradas a partir de 1. Uma lista que começa em outro número no HTML, como start="5", também é renumerada a partir de 1.
O que acontece com as tags que o conversor não reconhece?
Elas são desembrulhadas: a tag é descartada e seu texto mantido. Uma div ou span desaparece sem deixar rastro, enquanto script, style e elementos semelhantes são removidos junto com o conteúdo.
Ele consegue converter tabelas HTML?
Tabelas simples, sim: viram tabelas com barras verticais, com a primeira linha como cabeçalho. Células mescladas, tabelas aninhadas e links ou formatação dentro das células não são preservados.
Funciona com uma página web inteira?
Sim, mas converte tudo no corpo, incluindo menus de navegação e rodapés, como texto e links comuns. Para um artigo, cole apenas o HTML do artigo.
Por que o Markdown parece mais simples do que a página original?
O Markdown registra a estrutura — títulos, ênfase, links, listas —, não cores, fontes ou layout. CSS, formulários e widgets incorporados são descartados por design.
Meu HTML é enviado a um servidor?
Não. A conversão roda no seu navegador usando o DOMParser integrado, que não executa scripts do HTML colado, e nada do que você cola sai do seu dispositivo.

Ferramentas relacionadas

Mais em Dados, marcação e código