Sintassi Markdown: un riepilogo per uso

Markdown è testo semplice con pochi segni elementari. Questa pagina è un riepilogo. Trova cosa vuoi fare, copia l'esempio e vai.

Alcuni segni funzionano ovunque. Altri funzionano solo in certe app. Ogni sezione indica di che tipo si tratta:

  • Core: fa parte di CommonMark, lo standard di base. Funziona quasi ovunque.
  • GFM: un'estensione di GitHub Flavored Markdown, che aggiunge funzioni a CommonMark. La maggior parte delle app la supporta.
  • Funzione di GitHub: molto usata, ma non presente in nessuna delle due specifiche. Controlla la tua app.

Titoli (core)

Inizia la riga con da uno a sei segni #, poi uno spazio. Più segni # significano un titolo più piccolo.

# Title
## Section
### Subsection

Lo spazio conta. Sette segni # non sono un titolo.

Paragrafi e interruzioni di riga (core)

Una riga vuota inizia un nuovo paragrafo. Un semplice a capo dentro un paragrafo non interrompe la riga. Il testo prosegue.

Per un'interruzione di riga senza un nuovo paragrafo, termina la riga con due spazi o con una barra rovesciata:

First line\
Second line

Grassetto, corsivo e barrato

*italic* or _italic_
**bold** or __bold__
***bold and italic***
~~strikethrough~~

Corsivo e grassetto sono core. Il barrato è GFM. Usa gli asterischi se il segno si trova dentro una parola, perché _ non funziona dentro una parola.

Elenchi

- Mele
- Banane
  - Verdi
  - Gialle

1. Alzati
2. Prepara il tè
3. Leggi

- [ ] Scrivi la bozza
- [x] Invia la bozza

I punti elenco possono iniziare con -, + o *. Gli elenchi numerati usano un numero e un . o ). Il primo numero stabilisce da dove parte l'elenco.

Per annidare un elenco, fai rientrare l'elenco interno in modo che sia allineato al testo della voce sopra. Per - Banane, sono due spazi.

Punti elenco e numeri sono core. Gli elenchi di attività, le caselle [ ] e [x], sono GFM.

[PilcrowMD](https://pilcrowmd.com "Optional title")
<https://pilcrowmd.com>
https://pilcrowmd.com

Il primo è un link in linea: testo tra parentesi quadre, indirizzo tra parentesi tonde. Il secondo è un autolink tra parentesi angolari. Entrambi sono core.

Il terzo è un indirizzo nudo, senza segni. CommonMark non lo trasforma in un link. GFM sì, per gli indirizzi che iniziano con http://, https:// o www..

Per saltare a un titolo nello stesso file, collegati alla sua ancora:

## My first section

[Go to the section](#my-first-section)

Il link è un normale link in linea. Su GitHub l'ancora è ricavata dal testo del titolo: lettere minuscole, spazi trasformati in trattini, altra punteggiatura rimossa. Un secondo titolo con lo stesso testo riceve in più -1. Altre app possono costruire le ancore allo stesso modo, ma è una regola di GitHub, quindi provala.

Immagini

Come un link, con un ! davanti:

![A red apple on a table](apple.jpg)

Il testo tra parentesi quadre è la descrizione (il testo alternativo). La sintassi delle immagini è core.

Citazioni (core)

Inizia ogni riga con >:

> The best way to learn is to try.

Codice

Per un breve pezzo di codice dentro una frase, usa singoli apici inversi:

Run `npm test` before you commit.

Per mostrare un apice inverso dentro il codice, racchiudi il codice tra doppi apici inversi.

Per un blocco, usa una recinzione di tre apici inversi. Scrivi il nome del linguaggio dopo la recinzione di apertura:

```python
print("Hello")
```

Le recinzioni si possono fare anche con tre tilde ~~~. Il nome del linguaggio è facoltativo. Le app lo usano per colorare il codice. Tutto questo è core.

Linea orizzontale (core)

Tre o più -, * o _ da soli su una riga:

---

Lascia una riga vuota sopra ---. Subito sotto una riga di testo, trasforma invece quel testo in un titolo.

Tabelle (GFM)

Una tabella richiede una riga di intestazione, una riga di trattini e righe di dati:

| Fruit  | Price |
|--------|-------|
| Apple  | 1.20  |

Le tabelle hanno altre regole, come l'allineamento e l'escape della barra verticale. Vedi Tabelle Markdown: come scriverle e leggerle.

Escape: mostrare un segno come testo (core)

Metti una barra rovesciata prima di un segno per mostrarlo come testo semplice:

\*not italic\*

Qualsiasi segno di punteggiatura può essere sottoposto a escape in questo modo. Le barre rovesciate non funzionano dentro il codice.

Note a piè di pagina (funzione di GitHub)

This claim needs a source.[^1]

[^1]: Here is the source.

Le note a piè di pagina non fanno parte di CommonMark né della specifica GFM. GitHub le supporta. Il testo della nota compare in fondo alla pagina, ovunque lo scrivi nel file. GitHub non supporta le note a piè di pagina nei wiki.

Riquadri di avviso (funzione di GitHub)

Un riquadro di avviso è una citazione con un'etichetta sulla prima riga:

> [!NOTE]
> Useful information the reader should know.

I tipi sono NOTE, TIP, IMPORTANT, WARNING e CAUTION. Non fanno parte di nessuna delle due specifiche. Usali con parsimonia.

Leggere il Markdown

In un editor di testo semplice, tutti questi segni restano visibili. Un lettore Markdown li trasforma in una pagina ben organizzata.

PilcrowMD mostra tabelle, note a piè di pagina, riquadri di avviso in stile GitHub e link che saltano a un titolo, su Android e Mac. Su Mac mostra anche gli elenchi di attività.

Domande frequenti

Quale Markdown dovrei imparare per primo? I segni core: titoli, grassetto, corsivo, elenchi, link, codice e citazioni. Funzionano in ogni app Markdown. Aggiungi poi tabelle ed elenchi di attività, perché la maggior parte delle app supporta GFM.

Perché il mio Markdown appare diverso in un'altra app? Le app seguono regole diverse. CommonMark è la base, GFM vi aggiunge funzioni e alcune funzioni, come note a piè di pagina e riquadri di avviso, non fanno parte di nessuna delle due. Se un segno non funziona, probabilmente l'app non lo supporta.

Devo usare gli spazi dopo # e -? Sì. Scrivi # Title e - Item. Senza lo spazio, la riga resta testo semplice.

Anche su Mac: PilcrowMD per Mac (beta)