Guida alla Sintassi Markdown di Base
La sintassi markdown di base comprende gli 11 elementi di formattazione che John Gruber ha definito nel documento di progettazione originale del 2004, e quasi ogni applicazione markdown nel 2026 supporta ancora il set completo. Gli 11 elementi sono intestazioni, paragrafi, interruzioni di riga, enfasi, citazioni, elenchi, codice, linee orizzontali, link, immagini ed escape dei caratteri. Ogni elemento usa segni di punteggiatura già presenti sulla tua tastiera, e ognuno si converte in un tag HTML specifico. Tra i processori esistono piccole differenze, quindi questa guida segnala le scelte che rendono in modo identico ovunque. Ogni esempio qui sotto si incolla direttamente in un editor markdown con anteprima in tempo reale, e l'output renderizzato appare mentre digiti.
Intestazioni
Un'intestazione inizia con un numero di cancelletti (#) da 1 a 6 seguito da uno spazio, e il conteggio dei cancelletti stabilisce il livello da H1 a H6.
# Heading level 1
## Heading level 2
### Heading level 3
#### Heading level 4
##### Heading level 5
###### Heading level 6
Ogni riga si converte nel tag HTML corrispondente, quindi # Page Title rende un elemento h1 e ###### Fine Print rende un h6. Per le intestazioni markdown esiste anche una sintassi alternativa per i primi 2 livelli. Metti un numero qualsiasi di segni di uguale sulla riga sotto il testo per una H1, o un numero qualsiasi di trattini per una H2. La forma con # è nota come stile ATX; la forma sottolineata è nota come stile Setext.
Heading level 1
===============
Heading level 2
---------------
Buona pratica: metti una riga vuota prima e dopo ogni intestazione, e mantieni 1 spazio tra i cancelletti e il testo, così l'intestazione rende correttamente in ogni applicazione.
Paragrafi
Un paragrafo è composto da una o più righe consecutive di testo con una riga vuota sopra e sotto, e non richiede alcun marcatore.
The first paragraph ends here.
A blank line above this sentence starts a second paragraph.
Il renderizzatore racchiude ogni blocco in un tag p, quindi i 2 blocchi qui sopra diventano 2 paragrafi HTML separati. I singoli a capo dentro un blocco si fondono in testo continuo, il che significa che puoi mandare a capo le righe sorgente a 80 caratteri e l'output resta un unico paragrafo ininterrotto.
Buona pratica: mantieni ogni paragrafo allineato al margine sinistro, perché 4 o più spazi iniziali trasformano un paragrafo in un blocco di codice.
Interruzioni di Riga
Un'interruzione di riga dentro un paragrafo richiede 2 o più spazi finali alla fine di una riga, oppure il tag HTML <br>.
This line ends with 2 trailing spaces.
This line appears directly below it.
This line ends with a br tag.<br>
This line also sits inside the same paragraph.
Entrambi i metodi rendono un elemento br, quindi la seconda riga finisce direttamente sotto la prima senza lo stacco di un paragrafo. Un a capo semplice senza nulla dopo fonde le 2 righe in una sola. CommonMark accetta anche una barra rovesciata finale come interruzione, ma i processori più vecchi la ignorano, quindi le 2 opzioni portabili restano gli spazi finali e il tag <br>.
Buona pratica: scegli il tag <br> quando un'interruzione deve sopravvivere al copia-incolla e alla revisione del codice, perché gli spazi finali restano invisibili nella maggior parte degli editor.
Enfasi
Il grassetto in markdown richiede 2 asterischi per lato, il corsivo ne richiede 1 e il grassetto corsivo 3; i trattini bassi funzionano come alternativa equivalente intorno a parole intere.
This word is **bold** and so is this __word__.
This word is *italic* and so is this _word_.
This phrase is ***bold and italic***.
Il renderizzatore converte i marcatori in tag strong ed em: **bold** diventa <strong>bold</strong>, *italic* diventa <em>italic</em>, e il marcatore triplo annida un tag dentro l'altro. L'enfasi funziona anche dentro una parola, quindi un*believ*able mette in corsivo solo le 6 lettere centrali.
Buona pratica: usa gli asterischi invece dei trattini bassi per l'enfasi a metà parola, perché ogni processore principale gestisce gli asterischi interni allo stesso modo, mentre i trattini bassi interni variano.
Citazioni
Una citazione inizia con un segno di maggiore (>) all'inizio di una riga, e ogni riga citata porta il proprio marcatore.
> A single-paragraph quote needs 1 marker per line.
>
> A marked blank line continues the quote into a second paragraph.
>
>> Two markers push this paragraph 1 level deeper as a nested quote.
L'output è un elemento blockquote, e il marcatore doppio annida una seconda citazione dentro la prima. Le citazioni contengono anche altro markdown. Un'intestazione, un elenco o del testo in grassetto rendono normalmente dentro la citazione quando ognuna delle loro righe inizia con il marcatore >, il che è ideale per email citate e passaggi citati con una struttura propria.
Buona pratica: circonda ogni citazione con righe vuote, così ogni processore rileva esattamente dove la citazione inizia e finisce.
Elenchi
Un elenco ordinato mette un numero e un punto prima di ogni voce, e un elenco puntato mette un trattino, un asterisco o un segno più prima di ogni voce.
1. First step
2. Second step
3. Third step
1. Indented sub-step
- Bullet item
- Bullet item
- Nested bullet
Gli elenchi ordinati rendono come elementi ol e contano dal primo numero che digiti, quindi un elenco scritto come 1, 8, 3 produce comunque 1, 2, 3. Gli elenchi markdown puntati rendono come elementi ul con uno qualsiasi dei 3 delimitatori. Un rientro di 4 spazi o 1 tabulazione annida un sotto-elenco, e lo stesso rientro tiene altri elementi dentro una voce di elenco: un paragrafo o una citazione richiedono 4 spazi, mentre un blocco di codice dentro un elenco richiede 8 spazi, perché il rientro standard di 4 spazi del codice si somma al rientro dell'elenco.
Buona pratica: mantieni 1 solo stile di delimitatore per elenco e chiudi i numeri ordinati con il punto anziché con la parentesi, perché la forma con il punto funziona in ogni applicazione markdown.
Codice
Il codice inline sta tra singoli backtick, e un blocco di codice è qualsiasi serie di righe rientrate di almeno 4 spazi o 1 tabulazione.
Type `git status` to check the working tree.
<html>
<head></head>
</html>
La coppia di backtick rende un elemento code in un font a spaziatura fissa, e il blocco rientrato rende dentro tag pre e code con ogni spazio preservato. Uno snippet che contiene a sua volta un backtick richiede doppi backtick intorno, quindi the outer pair displays `code` literally. I blocchi di codice delimitati da tripli backtick appartengono alla sintassi estesa; il rientro di 4 spazi è il metodo originale.
Buona pratica: racchiudi i backtick letterali in doppi backtick, così il carattere interno viene stampato invece di chiudere in anticipo lo span di codice.
Linee Orizzontali
Una linea orizzontale richiede 3 o più asterischi, trattini o trattini bassi da soli su una propria riga.
***
---
___
Tutte e 3 le versioni rendono un elemento hr identico, un divisore a tutta larghezza. Il carattere può ripetersi oltre 3 senza alcuna differenza nell'output, quindi una riga di 20 trattini produce la stessa linea di 3. Chi scrive usa le linee per segnare cambi di scena e confini di sezione dove un'intestazione risulterebbe troppo pesante.
Buona pratica: lascia una riga vuota sopra e sotto ogni linea, perché una riga di soli trattini posta direttamente sotto un testo trasforma quel testo in un'intestazione H2.
Link
Un link inline racchiude il testo del link tra parentesi quadre e lo fa seguire immediatamente dall'URL tra parentesi tonde, più un titolo opzionale tra virgolette.
Read the [original spec](https://daringfireball.net/projects/markdown/ "Gruber's 2004 spec").
Reference style keeps prose clean: read the [original spec][1].
[1]: https://daringfireball.net/projects/markdown/
Bare addresses work in angle brackets: <https://example.com> and <mail@example.com>
Ogni forma rende un elemento a, e il testo del titolo appare come tooltip al passaggio del mouse. I link in stile riferimento separano l'URL dalla frase: l'etichetta [1] punta a una definizione che può stare in qualsiasi punto del file, quindi un paragrafo pieno di URL lunghi resta leggibile nel sorgente. Le parentesi angolari convertono un URL o un indirizzo email grezzo in un link cliccabile senza testo aggiuntivo. I link accettano anche la formattazione, quindi gli asterischi intorno all'intera costruzione mettono il link in grassetto e i backtick dentro le parentesi quadre lo rendono come codice.
Buona pratica: codifica ogni spazio dentro un URL come %20, così l'indirizzo completo sopravvive in ogni processore.
Immagini
Un'immagine usa un punto esclamativo, poi il testo alternativo tra parentesi quadre, poi il percorso o l'URL dell'immagine tra parentesi tonde.
[](https://example.com/report)
La prima riga rende un elemento img con il testo alternativo come etichetta di accessibilità e il titolo tra virgolette come testo al passaggio del mouse. La sintassi corrisponde a quella di un link con 1 carattere in più davanti. La seconda riga annida l'intera costruzione dell'immagine dentro un link, quindi un clic sull'immagine apre l'URL di destinazione.
Buona pratica: scrivi un testo alternativo che descriva il contenuto dell'immagine, perché i lettori di schermo e i motori di ricerca lo leggono al posto dell'immagine.
Escape dei Caratteri
Una barra rovesciata () posta prima di un carattere di formattazione mostra quel carattere alla lettera invece di attivarne la funzione markdown.
\* This line shows a literal asterisk, not a bullet point.
1968\. The escaped period stops this year from starting an ordered list.
La barra rovesciata non appare mai nell'output; viene stampato solo il carattere che la segue. Markdown accetta l'escape con barra rovesciata per 12 caratteri: barra rovesciata, backtick, asterisco, trattino basso, graffe, parentesi quadre, parentesi tonde, cancelletto, segno più, segno meno, punto e punto esclamativo. Il secondo esempio qui sopra risolve una trappola comune, perché qualsiasi riga che inizia con un numero e un punto diventa una voce di elenco senza l'escape.
Buona pratica: applica l'escape solo ai caratteri di quella lista di 12 elementi, perché una barra rovesciata prima di qualsiasi altro carattere viene stampata come barra visibile.
Domande frequenti
Che cos'è la sintassi markdown di base?
La sintassi di base è il set di 11 elementi del documento di progettazione markdown di John Gruber del 2004, e quasi ogni applicazione markdown lo supporta per intero. Gli 11 elementi si comportano in modo coerente tra i processori, il che rende il set di base la scelta più sicura per i documenti che passano da una piattaforma all'altra.
Quanti livelli di intestazione supporta markdown?
Markdown supporta 6 livelli di intestazione, scritti con un numero di cancelletti da 1 a 6, e corrispondono direttamente ai tag HTML da h1 a h6. La sintassi alternativa sottolineata copre solo i primi 2 livelli: segni di uguale per la H1 e trattini per la H2.
Come aggiungo un'interruzione di riga senza iniziare un nuovo paragrafo?
Termina la riga con 2 spazi finali oppure con il tag HTML <br>. Entrambi rendono un elemento br dentro il paragrafo corrente. Una riga vuota ha un effetto diverso: chiude il paragrafo e ne apre uno nuovo.
La sintassi di base è sufficiente o mi serve quella estesa?
La sintassi di base copre i documenti standard, mentre la sintassi estesa aggiunge tabelle, blocchi di codice delimitati, note a piè di pagina e altri elementi da specifiche successive come GFM. Parti dal set di base per la massima compatibilità, poi aggiungi gli elementi estesi quando sai che la piattaforma di destinazione li supporta.