Markdown: Sintaxe de Títulos Markdown e Diretrizes de…
Títulos são o esqueleto do seu documento — eles informam tanto aos leitores quanto aos mecanismos de busca como seu conteúdo está organizado.
1. O Que Você Vai Aprender
- As duas sintaxes de títulos Markdown: ATX e Setext
- Como usar corretamente os seis níveis de título
- Regras de hierarquia de títulos e boas práticas
- Erros comuns com títulos e como corrigi-los
- Como os títulos afetam SEO e acessibilidade
2. A História Real de Uma Mantenedora de Documentos
(1) Problema: Hierarquia de Títulos Caótica
Sarah assumiu um projeto de blog técnico e descobriu que artigos anteriores usavam títulos de forma desorganizada — alguns usavam #, outros ##, alguns não tinham títulos e outros pulavam de H1 direto para H3, ignorando completamente o H2. Como resultado, o gerador de índice do site estava completamente quebrado e os leitores reclamavam que não conseguiam encontrar o conteúdo.
(2) Solução: Regras de Título Padronizadas
Sarah estabeleceu regras para títulos: cada artigo tem apenas um título #, e os títulos devem progredir passo a passo (## → ### → ####) sem pular níveis. Ela usou um script para corrigir todos os 50 artigos de uma vez. Após a correção, o índice gerado automaticamente voltou a funcionar e o tempo de permanência dos leitores na página aumentou 40%.
3. Duas Sintaxes de Títulos
O Markdown oferece duas sintaxes de títulos:
graph TB
A[Títulos Markdown] --> B[Estilo ATX]
A --> C[Estilo Setext]
B --> D[# até ######]
B --> E[Mais comum]
C --> F[=== e ---]
C --> G[Apenas H1 e H2]
| Sintaxe | Notação | Níveis Suportados | Ideal Para |
|---|---|---|---|
| ATX | # até ###### |
H1–H6 | Todos os cenários, mais universal |
| Setext | === / --- |
Apenas H1, H2 | Preferência de editores específicos, baixa compatibilidade |
(1) Estilo ATX (Recomendado)
O estilo ATX usa a quantidade de símbolos # para indicar o nível do título — um # para H1, dois ## para H2, e assim por diante:
# Título Nível 1 (H1)
## Título Nível 2 (H2)
### Título Nível 3 (H3)
#### Título Nível 4 (H4)
##### Título Nível 5 (H5)
###### Título Nível 6 (H6)
# antes do texto do título; caso contrário, alguns analisadores não o reconhecerão como título.
(2) Estilo Setext
O estilo Setext coloca === ou --- abaixo do texto do título:
Título Nível 1
=======
Título Nível 2
-------
▶ Exemplo: Comparando os Dois Estilos de Título
# H1 no Estilo ATX
H2 no Estilo ATX
============
Nota: a linha com === abaixo é renderizada como H1, mesmo que o texto diga "H2".
4. Diretrizes de Hierarquia de Títulos
(1) Usando a Hierarquia Corretamente
Os títulos do documento devem ter uma hierarquia clara, como o índice de um livro:
# Título do Documento (apenas um H1)
## Capítulo 1 (H2)
### 1.1 Seção (H3)
#### 1.1.1 Subseção (H4)
### 1.2 Seção (H3)
## Capítulo 2 (H2)
H2 → H2 é perfeitamente aceitável.
(2) Impacto no SEO e Acessibilidade
A hierarquia de títulos é muito importante para SEO e leitores de tela:
| Aspecto | Recomendado | Evitar |
|---|---|---|
| Quantidade de H1 | Um por página | Vários H1 confundem os mecanismos de busca |
| Palavras-chave | H1 contém termos principais, H2 contém termos relacionados | Excesso de palavras-chave |
| Hierarquia | Passo a passo, sem pular níveis | Saltos caóticos H1→H3→H2 |
| Comprimento | H1 ≤ 60 caracteres, H2 ≤ 40 caracteres | Parágrafos inteiros como títulos |
▶ Exemplo: Hierarquia de Títulos Correta vs. Incorreta
✅ Correto:
# Tutorial de Layout CSS
## Flexbox
### Propriedades do Contêiner Flex
### Propriedades dos Itens Flex
## Grid
### Propriedades do Contêiner Grid
❌ Incorreto:
# Tutorial de Layout CSS
### Propriedades do Contêiner Flex (pulou H2)
## Flexbox
#### Propriedades do Flexbox em Detalhes (salto estranho H3→H4)
## Grid
5. Formatação e Caracteres Especiais nos Títulos
(1) Você Pode Usar Negrito, Itálico e Código nos Títulos
## Instalando Dependências Com `npm install`
## Entendendo **flex-grow**, **flex-shrink** e **flex-basis**
## O Que É *Design Responsivo*?
(2) Evite Conteúdo de Título Excessivamente Longo
❌ Evitar:
## Um Tutorial Detalhado Sobre Como Usar a Biblioteca requests do Python para Enviar Requisições HTTP
✅ Recomendado:
## Enviando Requisições HTTP Com a Biblioteca requests
▶ Exemplo: Antes e Depois da Otimização de Títulos
❌ Muito longo:
## Este Artigo Vai Ensinar Como Configurar Um Ambiente de Desenvolvimento Python no VS Code no Windows
✅ Otimizado:
## Configurando Python no VS Code
6. Exemplo Completo: Estrutura de Títulos de Um Artigo
# Análise de Dados Com Python
## 1. Preparação dos Dados
### (1) Importando Bibliotecas
### (2) Lendo Dados
### ▶ Exemplo: Lendo Um Arquivo CSV
## 2. Limpeza de Dados
### (1) Tratando Valores Ausentes
### ▶ Exemplo: Preenchendo Valores Nulos
### (2) Removendo Duplicatas
## 3. Visualização de Dados
### (1) Gráficos de Linha
### ▶ Exemplo: Criando Um Gráfico de Tendência
### (2) Gráficos de Barras
Resultado esperado: Uma estrutura de documento claramente organizada em camadas que tanto leitores quanto mecanismos de busca podem entender rapidamente.
❓ Perguntas Frequentes
P: Um artigo pode ter vários H1? R: Tecnicamente sim, mas é fortemente desaconselhado. Um artigo deve ter apenas um H1 (geralmente o título). Vários H1 confundem os mecanismos de busca sobre qual é o conteúdo principal.
P: Devo adicionar um ponto final no final de um título? R: Não. Títulos não são frases completas, então não os termine com pontuação. Perguntas do FAQ podem terminar com ponto de interrogação, já que são perguntas.
P: O espaço entre
#e o texto do título é obrigatório? R: Sim, é obrigatório.#Títulonão será reconhecido como título — será tratado como texto simples.# Títuloé a forma correta.
P: Posso usar caracteres não ingleses nos títulos? R: Sim. No entanto, as âncoras de URL são geradas em inglês. Se precisar de âncoras estáveis, adicione um ID personalizado após o título como
{#id-personalizado}.
P: H5 e H6 raramente são usados. Eles importam? R: Sim. São úteis em documentos técnicos profundamente aninhados (cláusulas legais, descrições de parâmetros de API). Para artigos comuns, ir até H3 ou H4 geralmente é suficiente.
📖 Resumo
- Duas sintaxes de título: ATX (
#) e Setext (===); recomenda-se usar ATX em todo o documento - Sempre coloque um espaço após
#, ou não será reconhecido como título - Um H1 por página, progrida passo a passo sem pular níveis
- Mantenha os títulos curtos (H1 ≤ 60 caracteres); evite excesso de palavras-chave
- Os títulos podem incluir código, negrito, itálico e outras formatações
- Uma boa hierarquia de títulos serve tanto aos leitores quanto aos mecanismos de busca
📝 Exercícios
-
Iniciante: Escreva um pequeno texto em Markdown com títulos H1, H2 e H3 (escolha o tema — uma nota de leitura ou plano de estudo). Certifique-se de que cada nível de título tenha exatamente um
#a mais que o nível acima. -
Intermediário: Abra um documento que você escreveu recentemente e verifique se a hierarquia de títulos segue as regras. Se houver saltos de nível ou confusão, corrija-os. Depois conte quantos H1 você tem (a resposta correta é 1).
-
Desafio: Use a extensão Markdown All in One no VS Code para gerar um índice (digite
[TOC]ou use o comando) e verifique se sua hierarquia de títulos está correta. Se o índice gerado parecer estranho, seus níveis de título precisam de ajuste.
