O que é Markdown? Guia completo de sintaxe e formatação Markdown

O que é Markdown?

Markdown é uma linguagem de marcação leve criada por John Gruber em 2004. Seu objetivo é permitir que as pessoas escrevam conteúdo em um formato de texto simples, fácil de ler e escrever, e que pode ser convertido em HTML válido. Arquivos Markdown usam a extensão .md e são suportados por praticamente todas as plataformas de desenvolvimento, sistemas de gerenciamento de conteúdo e aplicativos de anotações.

A filosofia central do Markdown é que um documento deve ser legível mesmo em sua forma bruta, sem necessidade de renderização especial. Isso o torna ideal para controle de versão, edição colaborativa e documentação técnica.

Cabeçalhos

O Markdown suporta seis níveis de cabeçalhos, criados prefixando o texto com um a seis símbolos de cerquilha:

• # Cabeçalho 1 — O maior cabeçalho, tipicamente usado para títulos de página
• ## Cabeçalho 2 — Cabeçalhos de seções principais
• ### Cabeçalho 3 — Cabeçalhos de subseções
• #### Cabeçalho 4 a ###### Cabeçalho 6 — Cabeçalhos progressivamente menores

Formatação de texto

O Markdown oferece sintaxe simples para formatação básica de texto:

• Texto em negrito: Envolva o texto em asteriscos duplos (**negrito**) ou sublinhados duplos (__negrito__)
• Texto em itálico: Envolva o texto em asteriscos simples (*itálico*) ou sublinhados simples (_itálico_)
• Texto riscado: Envolva o texto em tils duplos (~~riscado~~)
• Código inline: Envolva o texto em crases (`código`)

Listas

O Markdown suporta listas ordenadas e não ordenadas:

• Listas não ordenadas: Use asteriscos (*), sinais de mais (+) ou hífens (-) como marcadores
• Listas ordenadas: Use números seguidos de pontos (1., 2., 3.)
• Listas aninhadas: Indente itens com dois ou quatro espaços para criar sublistas

Links e imagens

Adicionar links e imagens é simples:

• Links: [Texto do link](URL) cria um hiperlink
• Imagens: ![Texto alternativo](url-imagem) insere uma imagem
• Links por referência: Defina links no final do documento para melhor legibilidade

Blocos de código

Para código de múltiplas linhas, use crases triplas (```) ou tils triplos (~~~). Você pode especificar a linguagem de programação após o marcador de abertura para destaque de sintaxe.

Tabelas

As tabelas Markdown usam pipes e hífens para criar linhas e cabeçalhos. Tabelas básicas fazem parte do Markdown padrão, enquanto recursos estendidos como alinhamento de células usam a especificação GitHub Flavored Markdown (GFM).

Citações em bloco e linhas horizontais

Citações em bloco são criadas com o símbolo > e são úteis para citar fontes. Linhas horizontais podem ser criadas com três ou mais hífens (---), asteriscos (***) ou sublinhados (___).

A simplicidade e universalidade do Markdown o tornam o formato preferido para desenvolvedores, escritores e qualquer pessoa que precise criar conteúdo de texto bem estruturado rapidamente.