title: Sintaxe de títulos no Markdown description: ATX e Setext: duas formas de criar títulos em Markdown, com boas práticas para uma estrutura consistente.

Sintaxe de títulos no Markdown

Os títulos estruturam o documento. O Markdown suporta dois estilos: ATX e Setext.

Títulos estilo ATX

Para criar um título, coloca cardinal (#) antes do texto. A contagem de # define o nível.

# Título de nível 1
## Título de nível 2  
### Título de nível 3
#### Título de nível 4
##### Título de nível 5
###### Título de nível 6

Resultado

Título de nível 1

Título de nível 2

Título de nível 3

Título de nível 4

Título de nível 5

Título de nível 6

Fecho opcional

Podes “fechar” com # no fim (apenas estético):

# Título de nível 1 #
## Título de nível 2 ##
### Título de nível 3 ###

O número de # no fim é irrelevante; o nível é decidido pelos do início.

Títulos estilo Setext

Outra forma: sublinhar o texto com = (nível 1) ou - (nível 2).

Título de nível 1
=================

Título de nível 2
-----------------

Resultado

Título de nível 1

Título de nível 2

Boas práticas

Compatibilidade

Sem espaço entre # e o texto, há diferenças entre processadores. Mantém um espaço.

✅ Recomendado	❌ Evitar
# Título	#Título

Linhas em branco

Para melhor compatibilidade, adiciona uma linha em branco antes/depois do título.

Este é um parágrafo.

# Este é um título

Este é outro parágrafo.

Hierarquia

• Usa apenas um H1 por documento
• Mantém ordem lógica (não saltes níveis)
• Os títulos devem refletir a estrutura

Texto do título

• Sê conciso e claro
• Evita pontuação (especialmente ponto final)
• Prefere frases nominais
• Consistência entre títulos do mesmo nível

Saída HTML

Títulos convertem para as respetivas tags HTML:

# Título       →  <h1>Título</h1>
## Título      →  <h2>Título</h2>
### Título     →  <h3>Título</h3>
#### Título    →  <h4>Título</h4>
##### Título   →  <h5>Título</h5>
###### Título  →  <h6>Título</h6>

IDs de títulos (extensão)

Muitos processadores geram IDs automaticamente para âncoras:

<h1 id="markdown-sintaxe-de-titulos">Sintaxe de títulos em Markdown</h1>

Assim podes ligar para um título específico:

[Ligação ao título](#markdown-sintaxe-de-titulos)

Exemplo prático

Um exemplo de boa hierarquia de títulos:

# Manual do Produto

## Início rápido

### Instalação

#### Requisitos do sistema

#### Download e instalação

### Configuração básica

## Funcionalidades avançadas

### Definições personalizadas

### Gestão de plugins

## Resolução de problemas

### FAQ

### Contactar suporte

Esta hierarquia clara facilita leitura e navegação.

Sintaxe relacionada

• Parágrafos e quebras
• Listas
• Ligações