HTML to Markdown

O conversor lida com títulos (h1–h6), parágrafos, negrito, itálico, tachado, código inline, blocos de código delimitados, citações em bloco, linhas horizontais, links, imagens, listas ordenadas, listas não ordenadas, listas aninhadas e tabelas — cobrindo o conjunto completo de recursos do CommonMark e do GitHub Flavored Markdown (GFM). Elementos estruturais desconhecidos como div, section e article passam seus filhos de forma transparente, então nenhum conteúdo é perdido. A maioria dos HTMLs do mundo real — de uma exportação de CMS, um artigo extraído da web ou uma página de documentação — converte de forma limpa sem nenhum pós-processamento necessário.

O Pandoc é um poderoso conversor de linha de comando, mas precisa ser instalado, requer um terminal e conhecimento de seus parâmetros. É a ferramenta certa para pipelines automatizados no lado do servidor, mas é exagero para uma conversão pontual. O Turndown.js é a biblioteca JavaScript mais usada para conversão de HTML para Markdown — com mais de 2,5 milhões de downloads semanais no npm e mais de 10.800 estrelas no GitHub — e esta ferramenta usa a mesma abordagem de análise baseada em DOM que torna o Turndown confiável. A diferença é que tudo roda no seu navegador: sem instalação, sem linha de comando, sem ida ao servidor, e nenhum arquivo sai do seu dispositivo. O Turndown requer a configuração de um projeto Node; este conversor não.

O Markdown é o formato de texto simples padrão para redação técnica, documentação e gerenciamento de conteúdo. Converter HTML para Markdown permite importar conteúdo para o Notion ou Obsidian, enviá-lo para um repositório Git junto com o código, publicá-lo via geradores de sites estáticos como Astro, Hugo ou Jekyll, ou alimentá-lo em modelos de IA e LLMs. Pesquisas publicadas em 2024 mostram que o Markdown reduz o uso de tokens em 68–87% em comparação com HTML puro quando usado com grandes modelos de linguagem — uma diferença real de custo e precisão ao criar pipelines RAG ou preparar conjuntos de dados de ajuste fino.

Sim — a migração de CMS é um dos casos de uso profissional mais comuns. Cole o HTML exportado do WordPress, Confluence, SharePoint, Ghost ou qualquer outra plataforma e obtenha Markdown limpo para importar em um novo sistema. A exportação do WordPress fornece blocos de conteúdo HTML; o Confluence exporta páginas como HTML ou XHTML — ambos convertem de forma limpa. Para melhores resultados, cole apenas o corpo do conteúdo em vez do HTML completo da página, incluindo navegação e rodapé. Equipes já usaram a conversão de HTML para Markdown no navegador para migrar sites de documentação com 150–200 páginas em menos de dois dias, sem tocar na linha de comando.

As tabelas são convertidas para o formato de tabela de barras verticais do GitHub Flavored Markdown (GFM), com uma linha separadora de traços após a linha de cabeçalho. Esse formato funciona no GitHub, GitLab, VS Code preview, Notion, Obsidian, Docusaurus e praticamente todos os renderizadores modernos de Markdown. Tabelas aninhadas são achatadas porque o Markdown padrão não as suporta nativamente. O alinhamento de colunas — esquerda, centro, direita via atributo align ou CSS text-align — é preservado usando o posicionamento de dois-pontos na linha separadora (por exemplo: :--- para esquerda, :---: para centro, ---: para direita).

Sim. A conversão acontece inteiramente no seu navegador usando o parser DOM nativo — nenhum arquivo é enviado e nenhuma conexão com a internet é necessária após o carregamento da página. Isso torna seguro o uso com HTML confidencial, como documentação interna, referências de API proprietárias ou trabalho de clientes que não devem sair do seu dispositivo. Você pode verificar isso: abra o DevTools do navegador, vá para a aba Rede e confirme que nenhuma requisição de rede é disparada quando você cola HTML e aciona uma conversão. Nada sai da sua máquina.

Ela remove espaços e tabulações no final de cada linha da saída Markdown e colapsa múltiplas linhas em branco consecutivas em uma única linha em branco. Isso mantém os arquivos limpos e evita espaços em branco invisíveis que podem afetar a renderização em parsers de Markdown rigorosos — especialmente o do GitHub, que destaca espaços em branco no final como um problema de lint. Também facilita inserir a saída em ferramentas de documentação que executam verificações de espaços em branco. A opção é segura para deixar ativada em quase todos os casos. Apenas muito raramente os espaços em branco no final têm significado semântico.

Sim. Elementos ul e ol aninhados são processados recursivamente e cada nível é corretamente indentado na saída Markdown. Aninhamentos mistos — listas ordenadas dentro de listas não ordenadas, ou vice-versa — também são tratados corretamente. Uma lista não ordenada com três níveis de profundidade dentro de uma lista ordenada, por exemplo, recebe indentação de quatro espaços em cada nível, que é o padrão CommonMark. Este é um dos casos extremos em que os conversores baseados em regex frequentemente falham e produzem Markdown quebrado. A análise baseada em DOM lida com isso de forma confiável.

A saída segue o CommonMark com extensões do GitHub Flavored Markdown (GFM) para tabelas e tachado. O CommonMark é a especificação padronizada usada pela maioria das plataformas, e o GFM adiciona a sintaxe de tabela de barras verticais e o tachado com ~~ que o GitHub, GitLab e VS Code suportam. Isso torna a saída compatível com GitHub, GitLab, VS Code, Notion, Obsidian, Docusaurus, MkDocs e a maioria dos renderizadores modernos de Markdown. Se você precisar de CommonMark estrito sem extensões GFM, as tabelas são o único elemento que diferiria — todo o resto é idêntico.

Você pode colar qualquer fragmento HTML ou corpo de página completo. Para melhores resultados, cole apenas a área de conteúdo principal — não o documento completo com navegação, barra lateral e rodapé — para que a saída permaneça focada no conteúdo significativo. A maioria dos desenvolvedores copia apenas a div do artigo ou da documentação no painel Elements do DevTools do navegador (clique com o botão direito → Copiar → Copiar outerHTML). Isso fornece HTML de conteúdo limpo sem o chrome estrutural da página. O conversor também lida com HTML de página completa, mas a saída incluirá o texto de navegação convertido como uma lista simples de links, o que geralmente não é o que você deseja.

Sistemas de IA como Perplexity, ChatGPT e Gemini agora leem, fragmentam e reutilizam conteúdo da web para gerar respostas. O Markdown é o formato de entrada preferido deles porque elimina as tags de estrutura HTML que consomem tokens sem adicionar significado semântico. Um parágrafo envolvido em tags <p class="article-body"> custa mais tokens do que o mesmo parágrafo em Markdown simples. Pesquisas publicadas em 2024 mostram que o Markdown reduz o uso de tokens em 68–87% em comparação com HTML puro para o mesmo conteúdo — o que reduz diretamente o custo da API e melhora a relação sinal-ruído para pipelines de geração aumentada por recuperação (RAG).

Elementos de código inline (tags code não dentro de pre) são envolvidos em crases simples. Blocos de código (elementos pre > code) são envolvidos em blocos delimitados por crases triplas, o padrão CommonMark e GFM. Se o elemento code tiver uma classe como 'language-python' ou 'lang-python', o identificador de linguagem é extraído e preservado na cerca de abertura para destaque de sintaxe. Blocos de código convertidos de páginas README do GitHub ou sites de documentação retêm suas tags de linguagem na saída — portanto, o destaque de sintaxe que você tinha no HTML sobrevive no Markdown.

Markdownify e h2m são pacotes npm do Node.js para conversão programática de HTML para Markdown em um pipeline de build. São a escolha certa quando você precisa automatizar a conversão em centenas de arquivos em um script. Esta ferramenta de navegador cobre o caso de uso que eles não cobrem: conversões pontuais rápidas, conteúdo que você não pode compartilhar com um servidor e situações em que você não quer configurar um projeto Node. A qualidade da conversão é semelhante — todos os três usam análise baseada em DOM em vez de regex — mas esta ferramenta adiciona uma visualização ao vivo, botão de cópia e contagens de caracteres/palavras que a tornam mais prática para trabalho de conteúdo.

Sim, o conversor funciona totalmente em navegadores móveis. Cole HTML da área de transferência, acione a conversão e copie o resultado em Markdown — tudo pelo celular ou tablet. A interface se adapta a telas menores com painéis empilhados. Testado no Safari para iOS 17 e Chrome para Android 14. Um caso de uso móvel comum: pegar o HTML de um artigo pelo menu Compartilhar do navegador, convertê-lo e colar o Markdown diretamente no Obsidian ou Notion no mesmo dispositivo, sem precisar de um computador. Sem cadastro, sem download de app, sem limites.

Comentários HTML (<!-- ... -->) são removidos da saída, pois o Markdown não tem sintaxe de comentário e os comentários raramente fazem parte do conteúdo real. Tags de script e seus conteúdos também são descartados — JavaScript não tem significado no Markdown. Tags de style e atributos de style inline também são removidos; a estilização CSS não se traduz para Markdown, e o significado semântico (negrito, itálico, título) é preservado pelo tipo de elemento em vez do estilo visual. Se um span está em negrito via CSS em vez de uma tag strong ou b, esse estilo não será transferido — o que é o comportamento correto para uma conversão de formato de conteúdo.

Não. Não há servidor envolvido, portanto não há limite de tamanho além do que a memória do seu navegador consegue suportar. Na prática, o parser DOM do navegador pode lidar com vários megabytes de HTML sem problemas — muito mais do que qualquer página real de CMS. Se você estiver convertendo um arquivo HTML extremamente grande (a exportação completa de um livro, um artigo muito longo extraído da web), cole em seções em vez de tudo de uma vez para uma saída mais clara. A conversão em si leva milissegundos independentemente do tamanho, pois roda diretamente em JavaScript na sua aba do navegador.