O que é Markdown? Uma explicação completa da linguagem de marcação leve
Resposta rápida
Markdown é uma linguagem de marcação de texto simples que usa símbolos simples para formatar texto: # para títulos, ** para negrito, * para itálico, - para listas, [texto](url) para links. Ele foi projetado para ser legível como texto simples e conversível para HTML. Use nosso conversor gratuito de Markdown para HTML para renderizar Markdown em seu navegador.
Introdução
Markdown é uma linguagem de marcação leve criada por John Gruber em 2004 que usa formatação de texto simples para produzir documentos estruturados. O objetivo é a legibilidade - o texto fonte do Markdown deve ser parecido com o que representa, sem a confusão visual das tags HTML. Markdown é o padrão para arquivos README no GitHub, sites de documentação, postagens de blogs, comentários em plataformas como Reddit e Stack Overflow e aplicativos de anotações como Obsidian e Notion. Markdown é convertido em HTML para publicação na web.
Passo a passo
-
Aprenda a sintaxe básica
Títulos: #H1, ## H2, ### H3. Negrito: **texto**. Itálico: *texto*. Listas: - item ou 1. item. Links: [texto](url). Imagens: . Código: `inline` ou ```block```. Citações em bloco: > citação. Regra horizontal: ---.
-
Entenda a filosofia
Markdown foi projetado para ser legível como texto simples. A fonte deve parecer próxima da saída final renderizada - **negrito** parece negrito, # Título parece um título. Isso contrasta com HTML, onde <strong>negrito</strong> e <h1>Título</h1> estão visualmente confusos.
-
Aprenda as variantes
O Markdown original (especificação de Gruber) é mínimo. CommonMark é uma versão padronizada e bem especificada. GitHub Flavored Markdown (GFM) adiciona tabelas, tachados, listas de tarefas e links automáticos. MDX permite incorporar componentes React no Markdown. A maioria das ferramentas oferece suporte a GFM.
-
Converter Markdown em HTML
Markdown é convertido em HTML para publicação na web. # Olá torna-se <h1>Olá</h1>, **negrito** torna-se <strong>negrito</strong>. Geradores de sites estáticos (Astro, Hugo, Jekyll) convertem Markdown no momento da construção. Use nosso conversor Markdown para HTML para conversão instantânea.
Exemplos
Título e parágrafo
Entrada: # Título
Um parágrafo.
Saída: <h1>Title</h1>
<p>A paragraph.</p>
Negrito e itálico
Entrada: **negrito** e *itálico*
Saída: <strong>bold</strong> and <em>italic</em>
Link e imagem
Entrada: [text](https://example.com) and 
Saída: <a href="https://example.com">text</a> and <img src="image.png" alt="alt">
Problemas comuns
- Quebras de linha — uma única nova linha no Markdown não cria uma quebra de linha em HTML. Use dois espaços no final de uma linha ou duas novas linhas para uma quebra de parágrafo.
- Listas aninhadas – o recuo é importante. Use 2 ou 4 espaços consistentemente para itens aninhados; misturá-los pode quebrar a estrutura da lista.
- Raw HTML — a maioria dos analisadores Markdown passam por HTML bruto, mas alguns o higienizam. Verifique o comportamento do seu analisador se você incorporar HTML diretamente.
- Diferentes sabores —Original Markdown, CommonMark e GFM têm diferenças sutis. Verifique qual sabor sua plataforma alvo suporta.
Dicas
- Use Markdown para escrita e documentação — é muito mais fácil de ler e escrever do que HTML.
- GitHub Flavored Markdown (GFM) é a variante mais comum – adiciona tabelas, tachados e listas de tarefas.
- Escreva em Markdown e converta para HTML em tempo de construção para blogs e sites de documentação.
- Use nosso conversor Markdown para HTML para renderizar Markdown instantaneamente em seu navegador.