Promemoria Markdown

Passaggio 1 / 3 33%

Scegli un argomento Markdown

Inizia da un gruppo di esempi, quindi apri il riferimento completo.

La sintassi Markdown essenziale, organizzata per categoria e mostrata con il sorgente pronto da copiare e l’output di un vero parser. Comprende le basi di CommonMark (titoli, elenchi, enfasi, link, immagini e blocchi di codice delimitati) e le estensioni di GitHub Flavored Markdown (tabelle, elenchi di attività, testo barrato e collegamento automatico degli URL non formattati). Tienila a portata di mano quando passi tra GitHub, GitLab, Obsidian e generatori di siti statici.

Come usare il cheatsheet

  1. 1

    Sfoglia per categoria

    Salta a intestazioni, elenchi, codice, link, tabelle o estensioni GFM.

  2. 2

    Confronta sorgente e risultato

    Ogni esempio mostra il Markdown grezzo accanto all’output di un vero parser GFM.

  3. 3

    Copia il frammento

    Tocca copia per prendere il sorgente di qualsiasi esempio.

  4. 4

    Controlla l’etichetta della sintassi

    Ogni esempio è contrassegnato come CommonMark o GitHub Flavored Markdown (GFM).

Intestazioni

# Titolo H1
## Sezione H2
### Sottosezione H3

Usa lo stile ATX (#) piuttosto che Setext (=== sotto il testo). Ogni parser supporta entrambi, ma ATX è più facile da leggere in un diff.

Enfasi

*corsivo* o _corsivo_, **grassetto** o __grassetto__, ***grassetto corsivo***. GFM aggiunge ~~barrato~~.

Elenchi

Gli elenchi non ordinati usano -, * o + (scegline uno e attieniti a quello):

- Primo
- Secondo
  - Annidato (due spazi)

Gli elenchi ordinati si numerano automaticamente:

1. Elemento
1. Elemento
1. Elemento

Codice

Inline: `codice`. Blocchi delimitati con tag di linguaggio opzionale:

```python
def hello(name):
    return f"Ciao, {name}"
```

Indenta con quattro spazi per un blocco di codice se preferisci la sintassi più vecchia.

Link e immagini

[Testo del link](https://example.com)
[Link con titolo](https://example.com "Tooltip")
![Testo alternativo](/path/to/image.png)

Lo stile di riferimento mantiene gli URL lunghi fuori dal paragrafo:

Vedi la [documentazione][1].

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

Tabelle (GFM)

| Col A | Col B |
|-------|------:|
| a     |     1 |
| b     |    22 |

L’allineamento usa i due punti nella riga del separatore: :--- sinistra, :---: centro, ---: destra.

Elenchi di attività (GFM)

- [x] Fatto
- [ ] Da fare

Problemi comuni

  • Due spazi finali inseriscono un’interruzione di riga all’interno di un paragrafo. Un solo spazio unisce le righe.
  • Riga vuota richiesta prima della maggior parte degli elementi di blocco (intestazioni, elenchi, blocchi di codice).
  • Non indentare i marcatori di elenco con tabulazioni se il tuo renderer si aspetta spazi; indenta con due o quattro spazi.
  • Escape con backslash per punteggiatura letterale: \*non corsivo\*.
  • Virgolette intelligenti differiscono per renderer. GitHub le lascia inalterate; Pandoc le converte.

Domande frequenti

CommonMark definisce il nucleo portabile, inclusi titoli, elenchi, link e blocchi di codice delimitati con stringa informativa facoltativa. GFM aggiunge tabelle, elenchi di attività, testo barrato e collegamenti automatici per gli URL non formattati. Altri editor possono supportarne solo una parte o aggiungere estensioni proprie.

Markdown tratta un singolo newline come uno spazio. Per un <br>, termina la riga con due spazi finali o usa \ alla fine della riga in GFM.

Sì nella maggior parte dei parser, i tag HTML a livello di blocco vengono passati. Alcuni renderer lo sanitizzano (GitHub rimuove script inline e attributi di evento).

CommonMark non include una sintassi per l’indice. GitHub crea ancore per i titoli e mostra una struttura nei file con più titoli. Le altre piattaforme hanno regole proprie: MkDocs può usare [TOC] con l’estensione corrispondente, mentre Docusaurus ricava l’indice della pagina dai titoli.

Le regole di CommonMark e GFM sì. Obsidian aggiunge wikilinks ([[Nome pagina]]), callout e blocchi incorporati che sono solo per Obsidian, questi non sono in questo cheatsheet.

Strumenti correlati