Markdown Guida ai titoli: H1 a H6, le migliori pratiche e SEO

Le intestazioni sono la spina dorsale di qualsiasi documento Markdown. Definiscono la struttura, consentono la navigazione, influenzano l'accessibilità e influenzano SEO. Questa guida copre tutto ciò che riguarda Markdown rubriche sintassi, regole di gerarchia, differenze tra piattaforme e migliori pratiche.

Sintassi dell'intestazione

Markdown le intestazioni usano il # simbolo (stile ATX). Il numero di # caratteri determina il livello di rubrica:

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

C'è anche lo stile Setext (solo H1 e H2):

Heading 1
=========

Heading 2
---------

Tipo ATX (#) è preferibile è più esplicita e funziona per tutti e sei i livelli.

Che cosa significa ciascun livello

La maggior parte dei documenti utilizza solo H1H3. H4H6 indica di solito che la struttura del documento è troppo profonda.

H1: uno per pagina

L'intestazione H1 dovrebbe apparire esattamente una volta per ogni documento Markdown. Rappresenta il titolo del documento o l'argomento principale della pagina.

Bene .

# How to Convert Word to Markdown

Evitare:

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

I motori di ricerca e gli strumenti di accessibilità si aspettano un singolo H1 per pagina. Moltiplici H1 confondono entrambi.

Regole della gerarchia delle rubriche

Progredire sempre in sequenza. Non saltare i livelli:

Corretto:

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

Non corretto:

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

Saltare i livelli di intestazione viola l'espressione del documento e non soddisfa le linee guida WCAG sull'accessibilità.

Convertire Word intestazioni in Markdown

Quando si converte un documento Word con WordToMD, Words inserito nello schema degli stili di intestazione direttamente:

Il problema più comune: gli scrittori aumentano manualmente la dimensione del carattere invece di applicare lo stile Heading. Questo crea testo che sembra un titolo in Word ma converte in semplice testo in grassetto in Markdown. Vede la tabella Word a Markdown Guida di formattazione per come risolvere questo problema.

Identificatori di intestazione e collegamenti di ancoraggio

La maggior parte dei processori Markdown genera automaticamente ID dal testo dell'intestazione:

## Getting Started

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

Potete fare un link:

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

Regole per gli ID generati automaticamente:

• Piccole lettere tutti i caratteri
• Sostituire gli spazi con trattini
• Stripe caratteri speciali tranne trattini

Esempi:

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

Tabella dei contenuti

Per i documenti lunghi, generare un TOC utilizzando i collegamenti di ancoraggio dell'intestazione:

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

GitHub genera automaticamente un TOC nell'angolo in alto a sinistra di qualsiasi file Markdown con intestazioni.

SEO Considerazioni

Per Markdown utilizzato in siti statici (Jekyll, Hugo, Astro) e pubblicato sul web:

• H1 = titolo della pagina Includi la tua parola chiave principale. Uno per pagina.
• H2s = sezioni principali Includere naturalmente parole chiave secondarie
• H3s = sottosezioni Tematiche più specifiche
• Mantenere i titoli descrittivi Come installare le dipendenze battiti Installazione
• I titoli sono indicizzati dai motori di ricerca rendendoli scansionabili

Vede la tabella Word al generatore di siti statici per la pubblicazione di documenti Markdown sul web.

Accessibilità

I lettori di schermo usano la gerarchia degli intesti per aiutare gli utenti a navigare. Linee guida:

• Non saltare i livelli di rotta (H1 → H3 senza H2)
• Non utilizzare i titoli solo per la formattazione visiva (utilizzare il grassetto o CSS al posto)
• Rendere il testo del titolo significativo evitare la sezione 1, la parte A
• Mantenere i titoli concisi ma descrittivi

Rendering di intestazione per piattaforma

Notion supporta solo tre livelli di intestazione (chiamati intestazione 1, 2 e 3 nel loro editor, mappatura a H1H3).

Errori comuni

Dimenticando lo spazio dopo #

#Not a heading    ← Missing space
# This is correct

Lo spazio tra # e il testo dell'intestazione è richiesto in CommonMark.

Utilizzare le intestazioni per lo stile, non per la struttura Utilizzo ### rendere il testo leggermente più piccolo senza che sia una sottosezione reale rompe la struttura del documento. Utilizzare testo stilato o classi CSS al posto.

Super-nido Se hai bisogno di H5 e H6, considera se il contenuto dovrebbe essere diviso in pagine separate.

FAQ

Qual è la differenza tra gli stili di intestazione ATX e Setext? Utilizzazioni ATX # personaggi. Sette usi sottolinea il testo (=== per H1, --- per H2). L'ATX è preferito perché è inequivocabile e funziona per l'H1H6.

Posso avere più H2? Sì, questo è il punto. H2 definisce le sezioni principali, e un documento in genere ne ha diverse.

Salto dei livelli di rotta influenzerà SEO? Essa influenza l'accessibilità più che SEO direttamente, ma una struttura semantica pulita è un segnale positivo. I motori di ricerca preferiscono contenuti ben strutturati.

Il mio documento convertito ha tutti i titoli allo stesso livello. Cos'e' andato storto? Il documento Word ha usato la formattazione manuale invece degli stili di intestazione. Vede la tabella Word a Markdown Guida di formattazione per la cura.

Conclusioni

Markdown i titoli sono semplici nella sintassi ma importanti nell'impatto. Utilizzare H1 una volta come titolo del documento, H2 per le sezioni principali e H3 per le sottosezioni. Mantenere la gerarchia pulita, non saltare i livelli e scrivere un titolo descrittivo. Quando si convertono documenti Word con WordToMD, assicurarsi che la fonte utilizzi gli stili di intestazione integrati Word per una conversione pulita.