Foglio di riferimento rapido: Sintassi, formattazione e struttura del Markdown
Riferimento rapido per Markdown: titoli, elenchi, codice, tabelle e altro ancora.
La lingua Markdown viene utilizzata su Wikipedia e Hugo. Ha il supporto per intestazioni, elenchi, modifiche dello stile del carattere, immagini, citazioni di codice e tabelle. Qui tengo un breve riassunto della formattazione Markdown.
L’immagine sopra è prodotta da Flux - text to image AI.
Markdown è un linguaggio di markup leggero che puoi utilizzare per aggiungere elementi di formattazione ai documenti testuali. Questa guida fornisce un overview completo delle sintassi Markdown più utilizzate Markdown syntax, aiutandoti a creare documenti ben strutturati e visivamente gradevoli.
Questo foglio di riferimento fa parte del Documentation Tools in 2026: Markdown, LaTeX, PDF & Printing Workflows hub.
Intestazioni Markdown (H1–H6)
Le intestazioni in Markdown vengono create utilizzando il simbolo di cancelletto (#). Il numero di cancelletti prima del testo dell’intestazione indica il livello dell’intestazione.
# H1
## H2
### H3
#### H4
##### H5
###### H6
Testo in grassetto, corsivo e enfasi
Markdown fornisce diversi modi per enfatizzare il testo. Puoi utilizzare asterischi (*) o sottolineature (_) per il corsivo e doppie asterischi (**) o doppie sottolineature (__) per il grassetto.
Corsivo
*Corsivo* o _corsivo_
Grassetto
**Grassetto** o __grassetto__
Grassetto e corsivo
***Grassetto e corsivo*** o ___grassetto e corsivo___
Elenco ordinato e non ordinato
Markdown supporta sia gli elenchi ordinati che quelli non ordinati.
Elenchi non ordinati
- Elemento 1
- Elemento 2
- Sottoelemento 1
- Sottoelemento 2
Elenchi ordinati
1. Primo elemento
2. Secondo elemento
1. Sottoelemento 1
2. Sottoelemento 2
Hyperlink in Markdown
Puoi creare link racchiudendo il testo del link tra parentesi quadre ([]) e poi racchiudendo l’URL tra parentesi normali (().
[Link Text](URL)
Esempio
Visita [Markdown Guide](https://www.markdownguide.org/) per maggiori informazioni.
Inserimento di immagini
Le immagini vengono aggiunte utilizzando un punto esclamativo (!) seguito dal testo alternativo tra parentesi quadre e dall’URL dell’immagine tra parentesi normali.
Esempio
Citazioni e citazioni annidate
Le citazioni vengono create utilizzando il simbolo di maggiore (>).
> Questo è una citazione.
Citazioni annidate
> Questo è il primo livello di citazione.
>> Questa è una citazione annidata.
Codice inline e blocchi di codice
Puoi aggiungere codice inline racchiudendolo tra backtick (` ). Per i blocchi di codice, utilizza tre backtick (``` ) prima e dopo il codice.
Codice inline
Utilizza `printf()` per stampare testo in C.
Blocchi di codice
```python
def hello_world(): print("Hello, World!")
```
Per ulteriori informazioni sui blocchi di codice in Markdown, vedi il post dedicato: Using Markdown Code Blocks
Linee orizzontali (divisori)
Le linee orizzontali vengono create utilizzando tre o più trattini (—), asterischi (*), o sottolineature (_).
---
Tabelle
Le tabelle in Markdown vengono create utilizzando le pipe (|) e i trattini (-).
Esempio
| Intestazione 1 | Intestazione 2 |
|----------------|----------------|
| Cellula 1 | Cellula 2 |
| Cellula 3 | Cellula 4 |
Per le opzioni di allineamento, la formattazione a più colonne e le funzionalità specifiche di GFM, vedi Tables in Markdown: Complete Guide.
Elenco di compiti (checkbox)
Gli elenchi di compiti sono un tipo speciale di elenco che ti permette di creare checkbox.
Esempio
- [x] Compito completato
- [ ] Compito incompleto
Testo con barratura
Il testo con barratura viene creato utilizzando due tilde (~~).
~~Questo è testo barrato.~~
Highlight del testo
L’highlight del testo non è supportato nativamente in Markdown, ma alcuni renderer lo supportano utilizzando la sintassi ==.
Esempio
==Questo è testo evidenziato.==
Indici e sovraindici
Gli indici vengono creati utilizzando un caret (^) prima del testo, e i sovraindici vengono creati utilizzando un tilde (~) prima del testo.
Esempio
H~2~O è l'acqua.
E = mc^2
Equazioni matematiche (sintassi LaTeX)
Le equazioni matematiche possono essere aggiunte utilizzando la sintassi LaTeX all’interno di segni di dollaro ($).
Esempio
$$ E = mc^2 $$
Escape dei caratteri speciali
Per escapare i caratteri speciali, utilizza una barra rovesciata ().
Esempio
\*Corsivo\* o \_corsivo\_
Questo foglio di riferimento completo copre la sintassi Markdown essenziale necessaria per creare documenti ben formattati. Per ulteriori funzionalità avanzate e personalizzazioni, consulta la documentazione specifica del renderer o risorse aggiuntive. Se utilizzi Hugo, Hugo Commands Cheat Sheet è un utile riferimento complementare.
