Markdown Guia de títulos: H1 a H6, Melhores práticas e SEO

Os cabeçalhos são a espinha dorsal de qualquer documento Markdown. Eles definem a estrutura, permitem a navegação, afetam a acessibilidade e influenciam SEO. Este guia abrange tudo sobre Markdown rubricas sintaxe, regras de hierarquia, diferenças entre plataformas e melhores práticas.

Sintase de cabeçalho

Markdown cabeçalhos usam o # símbolo (estilo ATX). O número de # Os caracteres determinam o nível da rubrica:

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Há também o estilo Setext (apenas H1 e H2):

Heading 1
=========

Heading 2
---------

Estilo ATX (#) é preferível é mais explícito e funciona para todos os seis níveis.

O que significa cada nível de cabeçalho

A maioria dos documentos usa apenas H1H3. H4H6 indica normalmente que a estrutura do documento é demasiado profunda.

H1: Uma por página

Um cabeçalho H1 deve aparecer exatamente uma vez por documento Markdown. Representa o título do documento ou o tópico principal da página.

Bom .

# How to Convert Word to Markdown

Evitar:

# Section One
...
# Section Two  ← Don't use multiple H1s

Os motores de busca e as ferramentas de acessibilidade esperam um único H1 por página. Vários H1s confundem ambos.

Regras de hierarquia de cabeçalhos

Sempre avançando em direcção à sequência. Não salte os níveis:

Correcto:

# Document Title
## Section
### Subsection
#### Detail

Incorrecto:

# Document Title
#### Jumped to H4  ← Skips H2 and H3

Salvar os níveis de cabeçalho viola o esboço do documento e não cumpre as diretrizes de acessibilidade da WCAG.

Conversão de Word cabeçalhos para Markdown

Ao converter um documento Word com WordToMD, Words embutidos estilos de cabeçalho mapa diretamente:

O problema mais comum: escritores manualmente em negrito e aumentar o tamanho da fonte em vez de aplicar o estilo Heading. Isto cria texto que se parece com um cabeçalho em Word, mas converte para texto em negrito em Markdown. A seguir: Word para Markdown Guia de formatação para como resolver isto.

Identificadores de cabeçalho e links de âncora

A maioria dos processadores Markdown gera automaticamente IDs a partir do texto de cabeçalho:

## Getting Started

Geradores: <h2 id="getting-started">Getting Started</h2>

Você pode fazer um link para isso:

See the [Getting Started section](#getting-started).

Regras para IDs gerados automaticamente:

• Todos os caracteres em minúsculas
• Substituir espaços por guiões
• Descarregar caracteres especiais, exceto guiões

Exemplos:

• ## API Reference → #api-reference
• ## What's New? → #whats-new
• ## Step 1: Install → #step-1-install

Tabela de Conteúdos

Para documentos longos, gerar um TOC usando links de âncora de cabeçalho:

## Table of Contents
- [Installation](#installation)
- [Configuration](#configuration)
  - [Basic Settings](#basic-settings)
  - [Advanced Options](#advanced-options)
- [Usage](#usage)
- [FAQ](#faq)

GitHub gera automaticamente um TOC no canto superior esquerdo de qualquer arquivo Markdown com cabeçalhos.

SEO Considerações

Para Markdown utilizado em sites estáticos (Jekyll, Hugo, Astro) e publicado na web:

• H1 = título da página Inclua a sua palavra-chave principal. Uma por página.
• H2s = secções principais Incluir palavras-chave secundárias naturalmente
• H3s = subsecções Temas mais específicos
• Manter os títulos descritivos Como instalar dependências batidas Instalação
• Os cabeçalhos são indexados pelos motores de busca tornando-os exploráveis

A seguir: Word para o gerador de site estático para a publicação de documentos Markdown na web.

Acessibilidade

Os leitores de tela usam a hierarquia de cabeçalhos para ajudar os usuários a navegar. Orientações:

• Não salte os níveis de rotação (H1 → H3 sem H2)
• Não use cabeçalhos apenas para formatação visual (use negrito ou CSS em vez disso)
• Tornar o texto de cabeçalho significativo evitar Seção 1, Parte A
• Manter os títulos concisos, mas descritivos

Renda de cabeçalho por plataforma

Notion suporta apenas três níveis de cabeçalho (chamados de cabeçalho 1, 2 e 3 no seu editor, correspondendo a H1H3).

Erros comuns

Esquecer o espaço depois #

#Not a heading    ← Missing space
# This is correct

O espaço entre # e o texto do cabeçalho é exigido em CommonMark.

Utilização de cabeçalhos para o estilo, não para a estrutura Utilização ### tornar o texto ligeiramente menor sem que seja uma subseção real quebra a estrutura do documento. Use texto com estilo ou classes CSS em vez disso.

Excesso de nidificação Se precisar de H5 e H6, considere se o conteúdo deve ser dividido em páginas separadas.

FAQ

Qual é a diferença entre os estilos de cabeçalho ATX e Setext? Utilizações de ATX # personagens. O texto sublinha as utilizações (=== para o H1, --- para H2). O ATX é preferido porque é inequívoco e funciona para o H1H6.

Posso ter vários H2s? Sim, é esse o ponto. H2 define seções principais, e um documento normalmente tem vários.

O salto dos níveis de rotação afetará SEO? Afeta a acessibilidade mais do que SEO diretamente, mas uma estrutura semântica limpa é um sinal positivo. Os motores de busca preferem conteúdos bem estruturados.

O meu documento convertido tem todos os cabeçalhos no mesmo nível. O que deu errado? O documento Word usou formatação manual em vez de estilos de cabeçalho. A seguir: Word para Markdown Guia de formatação para a correcção.

Conclusão

Markdown cabeçalhos são simples na sintaxe, mas importante no impacto. Use H1 uma vez como título do documento, H2 para as seções principais e H3 para as subseções. Manter a hierarquia limpa, não pular níveis e escrever texto de título descritivo. Ao converter documentos Word com WordToMD, certifique-se de que a fonte usa Words estilos de cabeçalho embutidos para conversão limpa.