Conversor de HTML para Markdown Online

Conversor de HTML para Markdown

Cole um código HTML ou um texto formatado copiado de uma página, do Word, do Google Docs ou de um e-mail, e receba o Markdown equivalente: títulos, negrito, itálico, links, imagens, listas aninhadas, citações, blocos de código e tabelas. A conversão é feita no seu navegador, sem envio para servidor.

Como usar

Para texto formatado: selecione e copie o conteúdo na origem (Ctrl+C), clique no campo tracejado e cole (Ctrl+V). Quando você copia um trecho de uma página ou de um editor de texto, a área de transferência guarda duas versões: o texto simples e o HTML com a formatação. A ferramenta pega a versão HTML e a converte. No celular, toque e segure o campo e escolha “Colar”, ou use o botão Colar da área de transferência (o navegador pede permissão).

Para código HTML: cole o código no segundo campo. O Markdown aparece logo abaixo e é atualizado enquanto você edita.

Depois, ajuste as opções e clique em Copiar Markdown.

O que é convertido

Exemplo de entrada:

<h2>Instalação</h2>
<p>Rode <code>npm install</code> e leia o <a href="https://exemplo.com.br/guia">guia</a>.</p>
<ul>
  <li>Node 20 ou mais novo</li>
  <li><strong>Importante:</strong> reinicie o terminal</li>
</ul>

Saída:

## Instalação

Rode `npm install` e leia o [guia](https://exemplo.com.br/guia).

- Node 20 ou mais novo
- **Importante:** reinicie o terminal

O que é removido

O objetivo é ficar só com o conteúdo. Por isso a ferramenta descarta:

• <script>, <style>, <noscript>, <svg>, campos de formulário e botões;
• todos os atributos de apresentação: class, id, style, onclick e afins (do link ficam só o endereço e o título; da imagem, o endereço, o texto alternativo e o título);
• elementos ocultos com hidden ou display: none;
• comentários do HTML;
• links com javascript: (fica apenas o texto).

Tags que só agrupam conteúdo, como <div>, <span>, <section> e <font>, somem e o texto delas é mantido.

Opções

• Estilo de título: ATX, com cerquilhas (# Título), é o mais comum e funciona para os seis níveis. Setext sublinha o título com === (nível 1) ou --- (nível 2); os níveis 3 a 6 continuam em ATX, porque o Setext não os cobre.
• Marcador de lista: hífen (-) ou asterisco (*). Os dois produzem o mesmo resultado; escolha o que o seu projeto já usa.
• HTML sem equivalente: Markdown não tem sintaxe para subscrito, sobrescrito, sublinhado, <kbd>, <mark>, <details> ou vídeo incorporado. Em Descartar, a tag some e o texto fica (H₂O escrito com <sub> vira “H2O”). Em Manter como HTML, essas tags são preservadas no meio do Markdown, sem os atributos de apresentação — a maioria dos renderizadores, como o do GitHub, aceita HTML em linha. <iframe>, <video> e <audio> só aparecem neste modo.

Texto colado do Word e do Google Docs

Editores de texto geram um HTML cheio de estilos. A ferramenta trata os casos mais comuns:

• negrito, itálico e tachado aplicados por estilo (font-weight: 700, font-style: italic, text-decoration: line-through), como faz o Google Docs;
• trechos vizinhos com a mesma formatação são unidos, para não gerar **pala****vra**;
• listas do Google Docs, que vêm com a sublista fora do item;
• listas do Word para computador, que chegam como parágrafos com o marcador desenhado à parte.

Cores, tamanho de fonte, alinhamento de parágrafo e sublinhado não têm equivalente em Markdown e são descartados.

Limitações

• Tabelas: o formato GFM exige uma linha de cabeçalho e não tem células mescladas. Se a tabela não tiver <th>, a primeira linha vira o cabeçalho. colspan é preenchido com células vazias e rowspan é ignorado. Quebras de linha dentro da célula viram <br>. Tabelas de uma célula só ou com outra tabela dentro, usadas para diagramar (comuns em e-mails), são convertidas em texto corrido.
• Caracteres especiais do texto, como *, _, [ e crases, recebem barra invertida para não virarem formatação. É o comportamento correto, ainda que o resultado fique menos limpo.
• Tabelas, tachado e listas de tarefas são extensões do GitHub Flavored Markdown; renderizadores que seguem só o CommonMark básico podem não reconhecê-las.
• HTML muito irregular (títulos feitos só com fonte grande, listas feitas com hífens digitados) não tem estrutura para ser reconhecida: sai como parágrafo comum.

Para o caminho inverso, use o Conversor de Markdown para HTML. Para limpar ou inspecionar o código antes, há o Formatador de HTML e o Codificador de entidades HTML; para montar tabelas, o Gerador de Tabela HTML.

Perguntas frequentes

Como converter um documento do Word ou do Google Docs em Markdown?

Abra o documento, selecione o trecho (ou tudo, com Ctrl+A), copie e cole no campo tracejado desta página. Títulos precisam estar com os estilos “Título 1”, “Título 2” etc. do editor para virarem # e ##; texto apenas aumentado e em negrito continua sendo parágrafo.

O HTML que eu colo é executado na página?

Não. O código é analisado em um documento separado, que nunca é exibido nem inserido nesta página: scripts não rodam e imagens não são baixadas. A ferramenta só lê a estrutura para montar o texto em Markdown.

Meu conteúdo é enviado para algum servidor?

Não. Tudo acontece no navegador, inclusive a leitura da área de transferência. Pode colar documentos internos e rascunhos.

Por que apareceram barras invertidas no meu texto?

Porque o original tinha caracteres que o Markdown usa como sintaxe. 2 * 3 vira 2 \* 3 para que o asterisco não abra um itálico. Ao renderizar o Markdown, a barra some e o texto aparece igual ao original.

As imagens são convertidas?

A referência, sim: <img> vira ![texto alternativo](endereço). O arquivo da imagem não é copiado, então o endereço precisa continuar acessível. Imagens coladas do Word costumam apontar para arquivos temporários do computador e precisam ser enviadas à parte.

Qual a diferença entre Markdown, CommonMark e GFM?

Markdown é a sintaxe criada por John Gruber em 2004. CommonMark é uma especificação que define sem ambiguidade como interpretá-la. GFM (GitHub Flavored Markdown) é o CommonMark com extensões, entre elas tabelas, tachado e listas de tarefas. A saída desta ferramenta segue o CommonMark e usa extensões do GFM onde não há alternativa.