Sintassi dei Titoli in Markdown
I titoli sono gli elementi più importanti per organizzare la struttura di un documento. Markdown supporta due sintassi per i titoli: stile ATX e stile Setext.
Titoli Stile ATX
Per creare un titolo, aggiungi un cancelletto (#
) prima di una parola o frase. Il numero di cancelletto rappresenta il livello del titolo.
# Titolo Livello 1
## Titolo Livello 2
### Titolo Livello 3
#### Titolo Livello 4
##### Titolo Livello 5
###### Titolo Livello 6
Risultato Renderizzato
Titolo Livello 1
Titolo Livello 2
Titolo Livello 3
Titolo Livello 4
Titolo Livello 5
Titolo Livello 6
Sintassi di Chiusura Opzionale
Puoi opzionalmente "chiudere" i titoli stile ATX, solo per estetica:
# Titolo Livello 1 #
## Titolo Livello 2 ##
### Titolo Livello 3 ###
Il numero di #
alla fine non deve corrispondere all'inizio; il numero all'inizio determina il livello del titolo.
Titoli Stile Setext
Puoi anche aggiungere una riga di =
sotto il testo per un titolo di livello 1, o una riga di -
per un titolo di livello 2.
Titolo Livello 1
===============
Titolo Livello 2
---------------
Risultato Renderizzato
Titolo Livello 1
Titolo Livello 2
Best Practice per i Titoli
Considerazioni di Compatibilità
Quando non c'è spazio tra il cancelletto (#
) e il testo del titolo, diverse applicazioni Markdown possono gestirlo in modo diverso. Per compatibilità, aggiungi uno spazio tra il cancelletto e il testo del titolo.
✅ Consigliato | ❌ Non consigliato |
---|---|
# Questo è un titolo | #Questo è un titolo |
Uso delle Righe Vuote
Per compatibilità, aggiungi righe vuote prima e dopo i titoli.
Questo è un paragrafo.
# Questo è un titolo
Questo è un altro paragrafo.
Livelli dei Titoli
- Ogni documento dovrebbe usare solo un titolo di livello 1
- Mantieni i livelli dei titoli logici; non saltare i livelli
- I titoli dovrebbero riflettere la gerarchia strutturale del documento
Linee Guida per il Testo del Titolo
- Il testo del titolo dovrebbe essere conciso e chiaro
- Evita la punteggiatura (specialmente i punti)
- Usa gerundi o frasi nominali
- Mantieni la formattazione coerente per titoli dello stesso livello
Output HTML
I titoli Markdown vengono convertiti nei corrispondenti tag HTML:
# Titolo → <h1>Titolo</h1>
## Titolo → <h2>Titolo</h2>
### Titolo → <h3>Titolo</h3>
#### Titolo → <h4>Titolo</h4>
##### Titolo → <h5>Titolo</h5>
###### Titolo → <h6>Titolo</h6>
ID dei Titoli (Funzionalità Estesa)
Molti processori Markdown generano automaticamente ID per i titoli, che possono essere usati per creare link di ancoraggio:
<h1 id="sintassi-dei-titoli-in-markdown">Sintassi dei Titoli in Markdown</h1>
Questo ti permette di collegarti a un titolo specifico:
[Collegamento al titolo](#sintassi-dei-titoli-in-markdown)
Esempio Pratico
Di seguito un esempio di documento con una gerarchia di titoli ben strutturata:
# Manuale Utente
## Avvio Rapido
### Passaggi di Installazione
#### Requisiti di Sistema
#### Download e Installazione
### Configurazione Base
## Funzionalità Avanzate
### Impostazioni Personalizzate
### Gestione Plugin
## Risoluzione dei Problemi
### FAQ
### Contatta il Supporto
Una struttura di titoli chiara rende il documento facile da leggere e navigare.