Skip to content

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.

markdown
# 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:

markdown
# 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.

markdown
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.

markdown
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:

markdown
# 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:

html
<h1 id="sintassi-dei-titoli-in-markdown">Sintassi dei Titoli in Markdown</h1>

Questo ti permette di collegarti a un titolo specifico:

markdown
[Collegamento al titolo](#sintassi-dei-titoli-in-markdown)

Esempio Pratico

Di seguito un esempio di documento con una gerarchia di titoli ben strutturata:

markdown
# 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.

Sintassi Correlata

Built by www.markdownlang.com