Conversor de HTML para Markdown

Arquivo HTML versus URL

HTML para Markdown parte de um HTML que você já tem. URL para Markdown parte de um endereço de rede e baixa a página pública antes da conversão. Use um arquivo HTML salvo quando precisar processar um instantâneo conhecido, a exportação de um template ou conteúdo que o seu próprio sistema já tenha coletado. Use a ferramenta de URL quando a página pública for a fonte que você quer recuperar agora. O conversor de HTML não executa scripts para preencher conteúdo que falta, então uma estrutura de aplicativo salva pode conter pouco do artigo que você via no navegador. Inspecione a fonte que você envia e confirme que o texto de que precisa está realmente presente antes de depurar o resultado de Markdown.

Revisar o resultado

HTML para Markdown pode representar títulos, parágrafos, listas, links, código e tabelas simples em uma forma de texto compacta. O posicionamento CSS e os controles interativos não têm equivalente direto no Markdown comum. Uma página que usa elementos de título com sentido dá ao conversor um esqueleto mais claro do que uma página feita com contêineres genéricos estilizados. Revise a hierarquia de títulos exportada e uma lista aninhada representativa no código Markdown. No caso de uma tabela, confirme que o cabeçalho ainda descreve os valores que tem embaixo. O objetivo é uma representação legível do conteúdo do documento, não uma reconstrução do layout do navegador, do comportamento ao passar o mouse nem do tema visual.

Navegação e links

HTML para Markdown pode conservar a navegação, o texto do rodapé e outro conteúdo junto com o artigo. Não presuma que o conversor identificou um corpo de artigo nem que removeu todos os anúncios. Revise o início e o fim da exportação em busca de menus repetidos antes de adicioná-la a um índice de recuperação. Um arquivo HTML salvo também pode conter links relativos cujo significado dependa da localização original do site. Confira esses destinos no contexto em que você publica o Markdown e forneça uma referência de origem com sentido no seu próprio fluxo de trabalho. Converter a sintaxe de um link não prova que o destino ainda existe, e um arquivo local não oferece automaticamente o endereço base do site original.

Migrações de CMS

Teste HTML para Markdown com uma entrada representativa antes de exportar um CMS inteiro. Escolha uma entrada que inclua uma tabela, código, imagens, links e títulos aninhados para descobrir cedo as diferenças importantes. Compare o resultado no renderizador de destino, porque os motores de Markdown podem diferir em sua compatibilidade com extensões. Guarde a exportação HTML original como cópia de auditoria e registre a qual artigo ela pertence. Decida no seu processo de migração como lidar com a navegação repetida e os recursos de mídia; este conversor não publica conteúdo nem move os arquivos de um site por você. Uma exportação de Markdown revisada é um ponto de partida portátil para essa migração, não uma transferência de site concluída.

O que o arquivo preserva

Esta ferramenta converte um arquivo que você já tem. Ela não baixa nada da rede. A navegação, os rodapés e outros elementos repetitivos que estão no arquivo podem continuar aparecendo no Markdown: revise-os antes de incorporar. Para converter uma página web ativa por URL, use o conversor de URL para Markdown.

• As tags de título HTML (h1–h6) são mapeadas para títulos de Markdown.
• As tabelas HTML viram tabelas de barras de Markdown.
• Os blocos de script e estilo em linha são removidos; só o conteúdo visível do documento é preservado.