HTML para Markdown: Convertendo Conteúdo Web

HTML para Markdown: O Mapa de Conversão

Seja migrando um blog para um gerador de sites estáticos, convertendo documentação ou scraping de conteúdo, você precisa converter HTML para Markdown.

Mapeamento Tag-para-Markdown

HTML	Markdown
`<h1>Título</h1>`	`# Título`
`<strong>negrito</strong>`	`negrito`
`<em>itálico</em>`	`itálico`
`<a href="url">texto</a>`	`[texto](url)`
`<img src="url" alt="texto">`	`![texto](url)`
`<ul><li>item</li></ul>`	`- item`
`<blockquote>texto</blockquote>`	`> texto`

Conversão Programática

// Node.js — Turndown
import TurndownService from 'turndown';
const turndown = new TurndownService({ headingStyle: 'atx', codeBlockStyle: 'fenced' });
const markdown = turndown.turndown(html);

# Python — markdownify
from markdownify import markdownify
md = markdownify(html, heading_style='ATX')

Edge Cases

Listas aninhadas: Indente com 2-4 espaços
Estilos inline/classes: Removidos (Markdown não tem estilo)
Iframes/embeds: Sem equivalente Markdown — mantenha como HTML
Tabelas complexas: Markdown não suporta colspan/rowspan

Converta agora: HTML para Markdown — cole HTML, obtenha Markdown limpo.