UltKit

Converter HTML para Markdown

O HTML é a forma como o conteúdo é entregue; o Markdown é como cada vez mais pessoas preferem escrevê-lo e guardá-lo. Este conversor transforma arquivos .html em texto .md legível, para que o arquivo de um blog, uma central de ajuda ou um artigo salvo possa ir para um site estático, um cofre de notas ou um repositório Git.

Conversor de documentos

ou solte arquivos PDF, DOC, DOCX … aqui ·

Até 95 MB por arquivo· Até 20 arquivos· Apagados após 30 minutos

Saída

Os arquivos são processados em nossos servidores e apagados após 30 minutos.

Como usar esta ferramenta

  1. 1

    Envie os arquivos HTML

    Adicione arquivos .html ou .htm, até 20 por lote e 95 MB cada. Funciona com uma página salva do navegador, uma exportação de CMS ou um arquivo escrito à mão.

  2. 2

    Confira as configurações de texto

    Converter para é Markdown, Formatação é Simples, Codificação do texto é UTF-8 e Quebras de linha são LF, que combina com Git, geradores de sites estáticos e editores do macOS ou Linux.

  3. 3

    Converta para Markdown

    Clique em Converter para Markdown → e abra o .md em qualquer editor de texto para remover menus ou rodapés que sobraram. Os arquivos enviados são excluídos após 30 minutos.

Para converter HTML em Markdown, envie o arquivo .html e clique em Converter para Markdown →: os títulos viram linhas com #, os links viram texto, as listas mantêm marcadores e números, e as tabelas simples viram tabelas com barras verticais.

HTML para Markdown: quem precisa e por quê

John Gruber publicou o Markdown em 2004, com Aaron Swartz como colaborador, como uma forma de escrever para a web em texto simples que lê naturalmente mesmo antes de ser renderizado. Vinte anos depois, é o formato nativo dos READMEs do GitHub, de geradores de sites estáticos como Jekyll e Hugo, de ferramentas de documentação, de apps de notas como o Obsidian e das pastas de conteúdo de muitos sites modernos.

Isso cria um fluxo constante no sentido contrário ao habitual. Equipes que deixam um CMS baseado em banco de dados precisam de anos de posts como arquivos .md. Escritores salvam artigos em um cofre de notas. Desenvolvedores levam uma seção de ajuda antiga em HTML para um repositório de documentação como código, em que as mudanças são revisadas em pull requests. Em todos os casos o HTML é a única cópia, e reescrevê-lo à mão não é realista. A partir de documentos do Word, a tarefa equivalente é DOCX para Markdown.

Quais elementos HTML têm equivalente em Markdown

from ↓ · to →CommonMarkGitHub Flavored Markdown
Títulos h1–h6Títulos h1–h6 to CommonMark: yesTítulos h1–h6 to GitHub Flavored Markdown: yes
Links e imagensLinks e imagens to CommonMark: yesLinks e imagens to GitHub Flavored Markdown: yes
Listas e citaçõesListas e citações to CommonMark: yesListas e citações to GitHub Flavored Markdown: yes
Blocos de código e preBlocos de código e pre to CommonMark: yesBlocos de código e pre to GitHub Flavored Markdown: yes
Tabelas simples– Tabelas simples to CommonMark: noTabelas simples to GitHub Flavored Markdown: yes
Texto tachado– Texto tachado to CommonMark: noTexto tachado to GitHub Flavored Markdown: yes
Células mescladas de tabela– Células mescladas de tabela to CommonMark: no– Células mescladas de tabela to GitHub Flavored Markdown: no
Formulários, vídeo, iframes– Formulários, vídeo, iframes to CommonMark: no– Formulários, vídeo, iframes to GitHub Flavored Markdown: no
supported not offeredO CommonMark, especificado a partir de 2014, é o núcleo estrito; o GitHub Flavored Markdown, especificado em 2017, acrescenta tabelas, texto tachado e listas de tarefas. O que não tem forma em Markdown pode ficar como HTML puro, que ambos aceitam.

Resultado do conversor de HTML para Markdown: o que esperar

Nomes de classe, estilos inline, scripts e divs de layout são descartados, porque o Markdown descreve o significado, não a aparência. Negrito e itálico viram asteriscos duplos e simples, as quebras de linha dentro de um parágrafo são unidas, e entidades de caracteres como   viram caracteres comuns em UTF-8. Espere um arquivo .md bem menor que o HTML: as palavras ficam e a marcação sai.

MitoO Markdown reproduz qualquer layout HTML.

FatoEle cobre apenas a estrutura do texto; colunas, cores e caixas posicionadas não têm sintaxe em Markdown e são perdidas ou mantidas como HTML puro.

MitoUma página convertida está pronta para publicar do jeito que sai.

FatoMenus, avisos de cookies e rodapés vêm junto; apague-os e adicione o front matter se o seu gerador de sites esperar por ele.

MitoA saída em Markdown funciona igual em qualquer lugar.

FatoTabelas e texto tachado precisam de um renderizador GitHub Flavored Markdown; ferramentas CommonMark estritas os mostram como texto simples.

Características dos formatos HTML e Markdown

HTML

HyperText Markup Language (HTML)

HTML é a linguagem de marcação da web, descrita pela primeira vez por Tim Berners-Lee no início dos anos 1990 e hoje mantida pelo WHATWG como um padrão vivo. Um arquivo HTML descreve títulos, parágrafos, links, tabelas, imagens e formulários, enquanto o estilo costuma vir do CSS. Todo navegador o renderiza, e ele também é usado em modelos de e-mail e páginas da web salvas. Um único arquivo HTML costuma depender de imagens e folhas de estilo externas, por isso pode aparecer quebrado quando movido sozinho.

Compressão
–
Transparência
–
Animação
–
Lançamento
1993 · Tim Berners-Lee; maintained by WHATWG
Conversor de HTML

MD

Markdown

Markdown é uma sintaxe de marcação leve criada por John Gruber em 2004. Ela usa símbolos de texto simples, como # para títulos, * para ênfase e - para listas, que continuam legíveis como texto bruto e se convertem de forma limpa em HTML. É o padrão em arquivos README, documentação, wikis, aplicativos de notas e muitos geradores de sites estáticos. Existem vários dialetos, como CommonMark e GitHub Flavored Markdown, que diferem em detalhes como tabelas. Qualquer editor de texto abre arquivos .md.

Compressão
–
Transparência
–
Animação
–
Lançamento
2004 · John Gruber
Conversor de MD

O HTML é convertido em Markdown quando o conteúdo sai do lugar que o renderizava: um blog migrando para um gerador de sites estáticos, uma central de ajuda indo para um repositório de documentação baseado em Git, ou artigos salvos em um cofre do Obsidian, onde um texto simples e legível vale mais que a marcação.

Perguntas sobre HTML para MD

Posso converter uma página web salva junto com as imagens dela?

O conversor lê o arquivo .html que você envia. As tags de imagem viram links de imagem em Markdown que apontam para os mesmos caminhos ou URLs que a página usava, então as imagens hospedadas online continuam funcionando. A pasta local de imagens do "Salvar página como" do navegador não é enviada junto com o arquivo; copie-a para ao lado do .md e os caminhos relativos continuam valendo.

O que acontece com menus, barras laterais e rodapés?

Tudo o que está no arquivo é convertido, porque a ferramenta não tem como saber qual parte da página é o artigo. Para um resultado limpo, salve o post sem o tema quando o seu CMS permitir, ou apague depois as linhas de navegação do início e do fim do Markdown.

Como passar posts do WordPress para o Hugo ou o Jekyll?

A exportação nativa do WordPress é um arquivo XML, não HTML, então converta o HTML de cada post, copiado do editor de código ou salvo pelo navegador. Depois, adicione o front matter no topo de cada .md: o bloco entre duas linhas de três hifens que guarda título, data e tags. Hugo e Jekyll leem esse bloco a partir dali.

Por que algumas tabelas ficam estranhas no Markdown?

As tabelas em Markdown, incluídas pelo GitHub Flavored Markdown, têm uma linha de cabeçalho e não têm células mescladas. Uma tabela HTML simples é convertida sem problemas; uma tabela com colspan, rowspan ou listas aninhadas não tem forma em Markdown e acaba achatada. O Markdown aceita HTML puro, então você pode colar a tabela original de volta onde o layout importar.

O Markdown é um bom formato para enviar páginas a ferramentas de IA ou de busca?

Muitas vezes, sim. O Markdown mantém a estrutura que importa (títulos, listas, links e ênfases) e descarta atributos, scripts e estilos, então o mesmo artigo fica bem menor e mais fácil de processar. Use HTML para TXT se quiser nenhuma marcação.