Corso Markdown: Indice
Corso ragionato su Markdown per chi lo usa sul serio: note in Obsidian, documentazione, contenuti per il web.
Contesto di versione
Verificato il 21 agosto 2026. Specifica di riferimento: CommonMark 0.31.2 (28 gennaio 2024, ancora l’ultima). GitHub Flavored Markdown 0.29-gfm è fermo al 2019 ed è basato su CommonMark 0.29, non sulla 0.31. Gli esempi marcati ✅ sono stati eseguiti con un parser reale (markdown-it-py 4.0.0, preset CommonMark) e l’output riportato è quello vero, non ricostruito a memoria.
La cosa che quasi nessuno dice
Markdown non è un linguaggio: è una famiglia di dialetti incompatibili tra loro. “Markdown” da solo non è una risposta alla domanda “cosa succede se scrivo questo?“. Il 90% della frustrazione con Markdown viene da qui: scrivi in Obsidian, incolli su GitHub, e metà della formattazione sparisce.
Questo corso ti insegna dove passano i confini.
I moduli
| # | Modulo | Cosa impari |
|---|---|---|
| 1 | 01 - Markdown e i suoi dialetti | La mappa: Gruber, CommonMark, GFM, e perché lo 0.x |
| 2 | 02 - Blocchi - paragrafi, liste, codice | Le regole esatte dei blocchi, e la vera regola dell’indentazione |
| 3 | 03 - Inline - enfasi, link, escaping | Perché a*b*c diventa corsivo e a_b_c no |
| 4 | 04 - GitHub Flavored Markdown | Tabelle, task list, footnote, alert: cosa è spec e cosa no |
| 5 | 05 - Obsidian Flavored Markdown e portabilità | Wikilink, embed, callout, e cosa si rompe fuori |
| 6 | 06 - Frontmatter e Markdown per il web | YAML frontmatter, Astro, MDX, Markdoc |
| 7 | 07 - Strumenti, stile e trappole | markdownlint, Prettier, Pandoc, cheatsheet, errori comuni |
Percorso consigliato
Se già scrivi Markdown tutti i giorni, la parte che ti cambia la vita è 2 + 3 (le regole vere, non quelle che hai dedotto per tentativi) e 5 (la portabilità). Il modulo 1 è la mappa concettuale: cinque minuti, e ti risparmia mesi di confusione.
Le tre fonti che contano
- CommonMark spec: la specifica, con oltre 650 esempi eseguibili. Si consulta, non si legge.
- Dingus di CommonMark: incolli il tuo Markdown e vedi l’HTML e l’albero sintattico. Quando qualcosa non funziona, la risposta arriva in 10 secondi.
- GFM spec: le cinque estensioni di GitHub, più la pagina docs per tutto ciò che GitHub fa oltre la spec.
Per la sintassi di Obsidian: obsidian.md/help/obsidian-flavored-markdown
(i vecchi link help.obsidian.md ora redirigono qui).