Guia de Sintaxe Markdown: Do Básico ao Avançado
O Markdown é o formato de escrita que os programadores realmente gostam de utilizar. Sem clicar em menus de formatação, sem lutar com editores WYSIWYG — apenas texto simples com alguns símbolos que se converte em HTML limpo. Ficheiros README, documentação, artigos de blog, mensagens de chat e até este artigo são escritos em Markdown.
Pré-visualize o seu Markdown em tempo real com o nosso Previsualizador de Markdown — escreva de um lado, veja o resultado formatado do outro.
Sintaxe Básica
Cabeçalhos
# Cabeçalho 1
## Cabeçalho 2
### Cabeçalho 3
#### Cabeçalho 4
Utilize os cabeçalhos de forma hierárquica. Não salte níveis (saltar de H1 para H3) — prejudica tanto a legibilidade como a acessibilidade.
Ênfase
*itálico* ou _itálico_
**negrito** ou __negrito__
***negrito itálico***
~~riscado~~
Ligações e Imagens
[Texto da ligação](https://example.com)
[Ligação com título](https://example.com "Título")
Listas
- Item não ordenado
- Outro item
- Item aninhado
1. Primeiro item
2. Segundo item
3. Terceiro item
Citações
> Isto é uma citação.
> Pode abranger múltiplas linhas.
Código
Código Inline
Utilize crases para código inline: `const x = 42`
Blocos de Código
Crases triplas com um identificador de linguagem opcional:
```javascript
function greet(name) {
return `Hello, ${name}!`;
}
```
As linguagens suportadas incluem javascript, python, json, yaml, html, css, bash e muitas mais.
Tabelas
| Cabeçalho 1 | Cabeçalho 2 | Cabeçalho 3 |
|-------------|-------------|-------------|
| Célula 1 | Célula 2 | Célula 3 |
| Célula 4 | Célula 5 | Célula 6 |
Alinhamento:
| Esquerda | Centro | Direita |
|:---------|:------:|--------:|
| E | C | D |
Sintaxe Avançada
Listas de Tarefas
- [x] Tarefa concluída
- [ ] Tarefa pendente
- [ ] Outra tarefa
Notas de Rodapé
Aqui está uma afirmação[^1].
[^1]: Este é o conteúdo da nota de rodapé.
Listas de Definições
Termo
: Definição do termo
Linhas Horizontais
---
***
___
GitHub-Flavored Markdown (GFM)
O GitHub estende o Markdown padrão com funcionalidades úteis:
- URLs com ligação automática — URLs simples tornam-se clicáveis
- Listas de tarefas — Caixas de verificação em issues e PRs
- Tabelas — A sintaxe com barras verticais mostrada acima
- Riscado —
~~texto eliminado~~ - Destaque de sintaxe — Coloração de código específica por linguagem
- Emoji —
:smile:torna-se uma cara sorridente
Dicas de Escrita
- Mantenha os parágrafos curtos — 3-5 frases no máximo
- Utilize cabeçalhos para criar uma estrutura fácil de percorrer
- Prefira listas em vez de parágrafos longos para passos ou funcionalidades
- Adicione exemplos de código sempre que discutir conceitos técnicos
- Pré-visualize regularmente — o nosso Previsualizador de Markdown mostra o resultado enquanto escreve
Perguntas Frequentes
Qual é a diferença entre Markdown e HTML?
O Markdown é um formato de escrita simplificado que se converte em HTML. Abrange as necessidades de formatação mais comuns com muito menos sintaxe. Pode incorporar HTML em bruto no Markdown quando precisar de funcionalidades que o Markdown não suporta.
Que variante de Markdown devo utilizar?
O GitHub-Flavored Markdown (GFM) é o mais amplamente suportado. Adiciona tabelas, listas de tarefas e riscado ao Markdown padrão. O CommonMark é a especificação padronizada.
Posso utilizar Markdown para documentação?
Absolutamente. O Markdown é o padrão para ficheiros README, wikis e sítios de documentação. Ferramentas como MkDocs, Docusaurus e GitBook utilizam todas Markdown.
Recursos Relacionados
- Markdown vs Texto Rico — porque é que os programadores preferem texto simples
- Verificador de Diferenças de Texto — comparar ficheiros Markdown
- Previsualizador de Markdown — pré-visualizar Markdown em tempo real
- Ferramenta de Verificação de Diferenças de Texto — comparar ficheiros de texto e Markdown