Markdown cheat sheet: la sintassi GitHub-Flavored con esempi

Markdown è il modo più semplice per scrivere testo formattato che resta leggibile anche come testo semplice. Lo usano file README, documentazione, appunti, chat e siti statici. Questo cheat sheet raccoglie la sintassi che userai davvero, con particolare attenzione al GitHub-Flavored Markdown (GFM), il dialetto supportato da GitHub, GitLab, dalla maggior parte degli strumenti di documentazione e da Markdown Preview Editor.

Puoi incollare ogni esempio qui sotto nell’editor online per vedere il risultato affiancato.

Titoli

Inizia una riga con da uno a sei caratteri # seguiti da uno spazio. Un solo # è il titolo della pagina, ## una sezione, ### una sottosezione.

markdown# Titolo della pagina
## Sezione
### Sottosezione
#### Titolo più piccolo

Usa un solo titolo # per documento e non saltare livelli (per esempio da ## direttamente a ####). Screen reader e motori di ricerca usano la struttura dei titoli per capire la pagina e la maggior parte dei visualizzatori ne ricava un indice.

Paragrafi e interruzioni di riga

Un paragrafo è una o più righe di testo separate da una riga vuota. Un singolo a capo all’interno di un paragrafo viene ignorato: le righe vengono unite. Per forzare un’interruzione di riga, termina la riga con due spazi o con una barra rovesciata:

markdownPrima riga con due spazi finali  
Seconda riga nello stesso paragrafo.

Dopo una riga vuota inizia un nuovo paragrafo.

Enfasi

Molti editor, compreso Markdown Preview Editor, supportano anche alcune estensioni diffuse: ==evidenziato==, H~2~O per il pedice, x^2^ per l’apice e gli shortcode delle emoji come :smile:. Non fanno parte del GFM vero e proprio, quindi verifica la piattaforma di destinazione prima di farci affidamento.

Elenchi

Usa -, * o + per gli elenchi puntati e i numeri per gli elenchi numerati. Rientra di due-quattro spazi per annidare le voci.

markdown- Latte
- Pane
  - Integrale
  - Di segale
- Caffè

1. Clona il repository
2. Installa le dipendenze
3. Avvia la build

Negli elenchi numerati i numeri non devono essere corretti: 1. su ogni riga viene comunque visualizzato come 1, 2, 3. Se inizi con un numero diverso (per esempio 5.), l’elenco partirà da lì.

Elenchi di attività

Gli elenchi di attività sono un’estensione GFM che trasforma le voci in caselle di controllo. Sono perfetti per README, piani di rilascio e verbali delle riunioni.

markdown- [x] Scrivere la bozza
- [x] Aggiungere gli screenshot
- [ ] Pubblicare l’articolo

Link

markdown[Testo del link](https://example.com)
[Link con titolo](https://example.com "Mostrato al passaggio del mouse")
<https://example.com>

Leggi la [guida all’installazione][install].

[install]: https://example.com/docs/install

L’ultima forma è un link di riferimento: l’URL viene definito una sola volta in fondo al documento, così i paragrafi lunghi restano leggibili. I link relativi come [Setup](docs/setup.md) puntano ad altri file dello stesso progetto; in Markdown Preview Editor passano a quel documento se è aperto in un’altra scheda.

Immagini

Le immagini usano la sintassi dei link preceduta da un punto esclamativo. Il testo tra parentesi quadre è il testo alternativo: descrivi l’immagine per chi non può vederla.

markdown![Editor con anteprima in tempo reale](images/screenshot.png)
![Logo](https://example.com/logo.svg "Titolo facoltativo")

Quando visualizzi in anteprima un documento che fa riferimento a immagini locali, apri l’intera cartella o rilascia le immagini insieme al file .md, così il visualizzatore può risolvere i percorsi relativi.

Codice

Il codice in linea usa un singolo backtick. Per i blocchi, racchiudi il codice tra tre backtick e aggiungi il nome del linguaggio per l’evidenziazione della sintassi:

markdown```js
function greet(name) {
  return `Hello, ${name}!`;
}
```

Nomi di linguaggio comuni: js, ts, python, bash, json, yaml, html, css, sql, go, rust, diff. Se il codice stesso contiene tre backtick, racchiudilo tra quattro backtick, come nell’esempio sopra.

Tabelle

Separa le colonne con barre verticali e metti una riga di trattini sotto l’intestazione. I due punti nella riga di separazione impostano l’allineamento.

markdown| Funzione  | Gratis | Note                      |
|:----------|:------:|--------------------------:|
| Anteprima |   ✅   | Si aggiorna mentre scrivi |
| Esportare |   ✅   | HTML, PDF, .md            |

:--- allinea a sinistra, :---: centra e ---: allinea a destra. Nel sorgente le colonne non devono per forza essere allineate, ma un buon editor le mantiene leggibili. Markdown Preview Editor ha un pulsante tabella nella barra degli strumenti che inserisce un modello già pronto.

Citazioni e avvisi

Metti > all’inizio delle righe per citare un testo. GitHub supporta anche gli avvisi (alert): citazioni con una prima riga speciale che vengono visualizzate come riquadri colorati:

markdown> Una citazione normale.

> [!NOTE]
> Informazioni utili che gli utenti dovrebbero conoscere.

> [!TIP]
> Un consiglio utile per fare le cose meglio.

> [!WARNING]
> Informazioni urgenti che richiedono attenzione immediata.

I cinque tipi di avviso sono NOTE, TIP, IMPORTANT, WARNING e CAUTION. Usali con moderazione: un avviso per sezione si fa notare, cinque di fila diventano rumore.

Note a piè di pagina

Le note a piè di pagina tengono le osservazioni secondarie fuori dal testo principale. La nota può essere definita ovunque e viene visualizzata alla fine del documento.

markdownMarkdown è nato nel 2004.[^1]

[^1]: Da John Gruber, con l’aiuto di Aaron Swartz.

Linee orizzontali ed escape

Tre o più trattini, asterischi o trattini bassi su una riga a sé creano una linea orizzontale: ---. Metti una riga vuota prima, altrimenti --- sotto una riga di testo trasforma quel testo in un titolo.

Per mostrare un carattere che Markdown interpreterebbe, fanne l’escape con una barra rovesciata: \*non corsivo\*, \# non un titolo, \$5 (utile quando le formule sono attive).

Formule e diagrammi

Due estensioni sono ormai standard nella scrittura tecnica:

• Formule: $E = mc^2$ per le formule in linea e $$ … $$ per le equazioni in evidenza. Leggi la guida completa su come scrivere formule matematiche in Markdown.
• Diagrammi: un blocco di codice con il linguaggio mermaid disegna diagrammi di flusso, di sequenza, di Gantt e altro. Vedi diagrammi Mermaid in Markdown.

Front matter

I generatori di siti statici leggono i metadati da un blocco YAML all’inizio del file:

yaml---
title: Il mio articolo
date: 2026-09-27
tags: [markdown, docs]
---

Un buon visualizzatore nasconde questo blocco invece di mostrarlo come testo. Markdown Preview Editor fa esattamente questo.

E adesso?

Conoscere la sintassi è metà del lavoro; l’altra metà è vedere il risultato mentre scrivi. Scopri come visualizzare Markdown online senza caricare i tuoi file e, quando il documento è pronto, impara a convertire Markdown in HTML o PDF.