HTML to Markdown

O conversor suporta títulos (h1–h6), parágrafos, negrito, itálico, texto riscado, código inline, blocos de código com crases, citações, regras horizontais, links, imagens, listas ordenadas, listas não ordenadas, listas aninhadas e tabelas — cobrindo o conjunto completo de funcionalidades do CommonMark e do GitHub Flavored Markdown (GFM). Elementos estruturais desconhecidos como div, section e article passam os seus filhos de forma transparente, pelo que nenhum conteúdo é perdido. A maioria do HTML do mundo real — de uma exportação de CMS, um artigo extraído da web, ou uma página de documentação — converte-se de forma limpa sem qualquer pós-processamento necessário da sua parte.

O Pandoc é um conversor de linha de comandos poderoso, mas requer instalação, um terminal e conhecimento das suas opções. É a ferramenta certa para pipelines automatizados do lado do servidor, mas excessiva para uma conversão pontual. O Turndown.js é a biblioteca JavaScript mais utilizada para converter HTML em Markdown — com mais de 2,5 milhões de descarregamentos semanais no npm e mais de 10.800 estrelas no GitHub — e esta ferramenta utiliza a mesma abordagem de análise baseada no DOM que torna o Turndown fiável. A diferença é que tudo corre no seu navegador: sem instalação, sem linha de comandos, sem viagem ao servidor, e nenhum ficheiro sai do seu dispositivo. O Turndown requer uma configuração de projeto Node; esta ferramenta não.

O Markdown é o formato de texto simples padrão para escrita técnica, documentação e gestão de conteúdo. Converter HTML para Markdown permite importar conteúdo para o Notion ou Obsidian, confirmar num repositório Git junto ao código, publicá-lo através de geradores de sites estáticos como o Astro, Hugo ou Jekyll, ou alimentar modelos de IA e LLMs. Investigação publicada em 2024 mostra que o Markdown reduz o uso de tokens em 68–87% em comparação com o HTML em bruto quando utilizado com grandes modelos de linguagem — uma diferença real em custo e precisão ao construir pipelines RAG ou preparar conjuntos de dados para ajuste fino.

Sim — a migração de CMS é um dos casos de utilização profissional mais comuns. Cole HTML exportado do WordPress, Confluence, SharePoint, Ghost ou qualquer outra plataforma e obtenha Markdown limpo que pode importar para 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é. Equipas utilizaram 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 comandos.

As tabelas convertem 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, pré-visualização do VS Code, Notion, Obsidian, Docusaurus e praticamente todos os renderizadores Markdown modernos. As tabelas aninhadas são achatadas porque o Markdown padrão não as suporta nativamente. O alinhamento de colunas — esquerda, centro, direita via o atributo align ou CSS text-align — é preservado utilizando a colocação de dois pontos na linha separadora (por exemplo: :--- para esquerda, :---: para centro, ---: para direita).

Sim. A conversão acontece inteiramente no seu navegador utilizando o analisador DOM integrado — nenhum ficheiro é carregado e não é necessária ligação à internet após a página carregar. Isto torna-o seguro para usar com HTML confidencial, como documentação interna, referências de API proprietárias, ou trabalho de clientes que não deve sair do seu dispositivo. Pode verificar isto: abra as Ferramentas de Desenvolvimento do navegador, vá ao separador Rede, e confirme que nenhum pedido de rede é feito quando cola HTML e desencadeia uma conversão. Nada sai da sua máquina.

Remove espaços e tabulações no final de cada linha da saída Markdown, e colapsa múltiplas linhas em branco consecutivas numa única linha em branco. Isto mantém os ficheiros limpos e evita espaços em branco invisíveis que podem afetar a renderização em analisadores Markdown estritos — especialmente o do GitHub, que destaca os espaços finais como um problema de lint. Também torna a saída mais fácil de usar em ferramentas de documentação que executam verificações de espaços em branco. A opção é segura para deixar ativa em quase todos os casos. Apenas muito raramente o espaço em branco no final tem significado semântico.

Sim. Os elementos ul e ol aninhados são processados recursivamente e cada nível é corretamente indentado na saída Markdown. O aninhamento misto — listas ordenadas dentro de listas não ordenadas, ou vice-versa — também é tratado corretamente. Uma lista não ordenada com três níveis de profundidade dentro de uma lista ordenada, por exemplo, obtém a indentação adequada de quatro espaços em cada nível, que é o padrão CommonMark. Este é um dos casos extremos em que os conversores baseados em expressões regulares falham frequentemente e produzem Markdown danificado. A análise baseada no DOM trata-o de forma fiável.

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

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 se mantenha focada no conteúdo relevante. A maioria dos programadores copia apenas o div do artigo ou da documentação a partir do painel Elementos das Ferramentas de Desenvolvimento do navegador (clique direito → Copiar → Copiar outerHTML). Isso fornece HTML de conteúdo limpo sem o esqueleto estrutural da página. O conversor também suporta HTML de página completa, mas a saída incluirá o texto de navegação convertido como uma lista plana de links, o que normalmente não é o pretendido.

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

Os elementos de código inline (etiquetas code não dentro de pre) são envolvidos em acentos graves simples. Os blocos de código (elementos pre > code) são envolvidos em blocos com 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 abertura do bloco para realce de sintaxe. Os blocos de código convertidos de páginas README do GitHub ou sites de documentação retêm as suas etiquetas de linguagem na saída — pelo que o realce de sintaxe que tinha em HTML sobrevive no Markdown.

O Markdownify e o h2m são pacotes npm do Node.js para conversão programática de HTML para Markdown num pipeline de build. São a escolha certa quando precisa de automatizar a conversão de centenas de ficheiros num script. Esta ferramenta de navegador cobre o caso de utilização que eles não cobrem: conversões pontuais rápidas, conteúdo que não pode partilhar com um servidor, e situações em que não pretende configurar um projeto Node de todo. A qualidade de conversão é semelhante — os três utilizam análise baseada no DOM em vez de expressões regulares — mas esta ferramenta adiciona uma pré-visualização em tempo real, 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, desencadeie a conversão e copie o resultado Markdown — tudo a partir de um telemóvel ou tablet. A interface adapta-se a ecrãs mais pequenos com painéis empilhados. Testado no Safari para iOS 17 e Chrome para Android 14. Um caso de utilização móvel comum: obter o HTML de um artigo a partir do menu Partilhar do seu navegador, convertê-lo, e colar o Markdown diretamente no Obsidian ou Notion no mesmo dispositivo, sem precisar de um computador. Sem registo, sem transferência de aplicação, sem limites.

Os comentários HTML (<!-- ... -->) são removidos da saída uma vez que o Markdown não tem sintaxe de comentários e os comentários raramente fazem parte do conteúdo real. As etiquetas script e os seus conteúdos também são descartados — o JavaScript não é significativo em Markdown. As etiquetas style e os atributos de estilo inline também são removidos; a estilização CSS não se traduz em Markdown, e o significado semântico (negrito, itálico, título) é preservado através do tipo de elemento em vez do estilo visual. Se um span estiver em negrito via CSS em vez de uma etiqueta 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á nenhum servidor envolvido, pelo que não há limite de tamanho além do que a memória do seu navegador consegue suportar. Na prática, o analisador DOM do navegador consegue lidar com vários megabytes de HTML sem problemas — muito mais do que qualquer página real de CMS. Se estiver a converter um ficheiro HTML extremamente grande (uma exportação de livro completo, um artigo muito longo extraído da web), cole-o em secções em vez de tudo de uma vez para uma saída mais clara. A própria conversão demora milissegundos independentemente do tamanho, porque corre diretamente em JavaScript no separador do seu navegador.