Guia Rápido de Markdown: Sintaxe, Formatação e Estrutura
Referência rápida de Markdown: títulos, listas, código, tabelas e muito mais.
A linguagem Markdown é utilizada na Wikipédia e Hugo. Ela possui suporte para cabeçalhos, listas, modificações de estilo de fonte, imagens, citações de código e tabelas. Aqui mantenho um breve resumo da formatação Markdown.
A imagem acima foi produzida por Flux - IA de texto para imagem.
Markdown é uma linguagem de marcação leve que você pode usar para adicionar elementos de formatação a documentos de texto simples. Este guia fornece uma visão geral abrangente da sintaxe Markdown mais comumente utilizada, ajudando você a criar documentos bem estruturados e visualmente atraentes.
Este resumo rápido faz parte do hub Ferramentas de Documentação em 2026: Markdown, LaTeX, PDF & Fluxos de Trabalho de Impressão.
Cabeçalhos Markdown (H1–H6)
Os cabeçalhos no Markdown são criados usando o símbolo de hash (#). O número de hashes antes do texto do cabeçalho indica o nível do cabeçalho.
# H1
## H2
### H3
#### H4
##### H5
###### H6
Negrito, Itálico e Ênfase
O Markdown oferece várias maneiras de enfatizar texto. Você pode usar asteriscos (*) ou sublinhados (_) para itálico e duplos asteriscos (**) ou duplos sublinhados (__) para negrito.
Itálico
*Itálico* ou _itálico_
Negrito
**Negrito** ou __negrito__
Negrito e Itálico
***Negrito e itálico*** ou ___negrito e itálico___
Listas Ordenadas e Não Ordenadas
O Markdown suporta tanto listas ordenadas quanto não ordenadas.
Lista Não Ordenada
- Item 1
- Item 2
- Subitem 1
- Subitem 2
Lista Ordenada
1. Primeiro item
2. Segundo item
1. Subitem 1
2. Subitem 2
Hiperlinks no Markdown
Você pode criar links envolvendo o texto do link em colchetes ([]) e, em seguida, envolvendo a URL em parênteses (()).
[Texto do Link](URL)
Exemplo
Visite [Guia Markdown](https://www.markdownguide.org/) para mais informações.
Incorporação de Imagens
As imagens são adicionadas usando um ponto de exclamação (!) seguido pelo texto alternativo em colchetes e a URL da imagem em parênteses.
Exemplo
Citações em Bloco e Citações Aninhadas
As citações em bloco são criadas usando o símbolo maior que (>).
> Esta é uma citação em bloco.
Citações em Bloco Aninhadas
> Este é o primeiro nível de citação.
>> Esta é uma citação em bloco aninhada.
Código em Linha e Blocos de Código Delimitados
Você pode adicionar código em linha envolvendo-o em crases (` ). Para blocos de código, use três crases (``` ) antes e depois do código.
Código em Linha
Use `printf()` para imprimir texto em C.
Blocos de Código
```python
python def hello_world(): print("Hello, World!")
```
Mais sobre blocos de código no Markdown - veja o post separado: Usando Blocos de Código Markdown
Regras Horizontais (Divisores)
As regras horizontais são criadas usando três ou mais traços (—), asteriscos (***), ou sublinhados (___).
---
Tabelas
As tabelas no Markdown são criadas usando barras verticais (|) e hífens (-).
Exemplo
| Cabeçalho 1 | Cabeçalho 2 |
|----------|----------|
| Célula 1 | Célula 2 |
| Célula 3 | Célula 4 |
Para opções de alinhamento, formatação de múltiplas colunas e recursos específicos do GFM, veja o Tabelas no Markdown: Guia Completo.
Listas de Tarefas (Caixas de Seleção)
As listas de tarefas são um tipo especial de lista que permite criar caixas de seleção.
Exemplo
- [x] Tarefa concluída
- [ ] Tarefa incompleta
Texto com Risca (Strikethrough)
O texto com risca é criado usando duplas tildes (~~).
~~Este é texto com risca.~~
Destaque de Texto
O destaque de texto não é suportado nativamente no Markdown, mas alguns renderizadores suportam usando a sintaxe ==.
Exemplo
==Este é texto destacado.==
Subscritos e Superscritos
Os subscritos são criados usando um acento circunflexo (^) antes do texto, e os superescritos são criados usando uma til (~) antes do texto.
Exemplo
H~2~O é água.
E = mc^2
Equações Matemáticas (Sintaxe LaTeX)
Equações matemáticas podem ser adicionadas usando a sintaxe LaTeX dentro de sinais de dólar ($).
Exemplo
$$ E = mc^2 $$
Escapando Caracteres Especiais
Para escapar caracteres especiais, use uma barra reversa ().
Exemplo
\*Itálico\* ou \_itálico\_
Este resumo abrangente cobre a sintaxe essencial do Markdown que você precisa para criar documentos bem formatados. Para recursos avançados e personalizações, consulte a documentação do renderizador específico ou recursos adicionais. Se você usa Hugo, a Lista de Comandos Hugo é uma referência companheira útil.
