Folha de Referência Rápida de Markdown: Sintaxe, Formatação e Estrutura
Referência rápida para Markdown: títulos, listas, código, tabelas e mais.
A linguagem Markdown é usada na Wikipédia e em Hugo. Ela oferece 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 em 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 puro. Este guia fornece uma visão abrangente da sintaxe do Markdown mais comumente usada, ajudando você a criar documentos bem estruturados e visualmente atraentes.
Este resumo faz parte do hub Ferramentas de Documentação em 2026: Markdown, LaTeX, PDF & Fluxos de Trabalho de Impressão.
Cabeçalhos em Markdown (H1–H6)
Os cabeçalhos em 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 o texto. Você pode usar asteriscos (*) ou sublinhados (_) para itálico e duplos asterisks (**) 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 em Markdown
Você pode criar links envolvendo o texto do link em colchetes ([]) e, em seguida, envolvendo o URL em parênteses (()).
[Texto do Link](URL)
Exemplo
Visite o [Guia de 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 o 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 Inline e Blocos de Código Delimitados
Você pode adicionar código inline envolvendo-o em crase (` ). Para blocos de código, use três crases (``` ) antes e depois do código.
Código Inline
Use `printf()` para imprimir texto em C.
Blocos de Código
```python
python def hello_world(): print("Olá, Mundo!")
```
Mais sobre blocos de código em markdown - veja o post separado: Usando Blocos de Código em Markdown. O identificador de linguagem mermaid é um caso especial notável — ele aciona a renderização de diagramas em vez de realce de sintaxe, transformando um bloco delimitado simples em um fluxograma ou diagrama de sequência. O Início Rápido de Diagramas Mermaid cobre a sintaxe completa de diagramas, desde fluxogramas até diagramas ER.
Regras Horizontais (Divisores)
As regras horizontais são criadas usando três ou mais traços (—), asteriscos (***) ou sublinhados (___).
---
Tabelas
As tabelas em Markdown são criadas usando pipes (|) 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, consulte o Tabelas em 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 Risco
O texto com risco é criado usando dois tildes (~~).
~~Este é um texto com risco.~~
Destaque de Texto
O destaque de texto não é suportado nativamente em Markdown, mas alguns renderizadores suportam usando a sintaxe ==.
Exemplo
==Este é um texto destacado.==
Subscritos e Superscritos
Os subscritos são criados usando um circunflexo (^) antes do texto, e os superscritos são criados usando um 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 cifrões ($).
Exemplo
$$ E = mc^2 $$
Escapando Caracteres Especiais
Para escapar caracteres especiais, use uma barra invertida ().
Exemplo
\*Itálico\* ou \_itálico\_
Este resumo abrangente cobre a sintaxe essencial de Markdown que você precisa para criar documentos bem formatados. Para recursos mais avançados e personalizações, consulte a documentação específica do renderizador ou recursos adicionais. Se você usar o Hugo, o Resumo de Comandos do Hugo é uma referência companheira útil.
O Markdown também é o formato de armazenamento padrão para wikis auto-hospedadas e sistemas de conhecimento. O DokuWiki usa uma abordagem de texto puro amigável ao Markdown para bases de conhecimento pessoais e de equipe. Para sistemas de conhecimento assistidos por IA construídos em páginas Markdown, o LLM Wiki explica por que a portabilidade e a capacidade de diferenciação do formato o tornam a base ideal para conhecimento compilado.
