Guida alla sintassi Markdown

Questa è una guida assolutamente non esaustiva alla sintassi Markdown, per l'uso in RMarkdown e Quarto.

È importante tenere presente che non esiste un solo “Markdown”: nel tempo sono nate diverse varianti, ognuna con funzionalità aggiuntive o adattamenti specifici per determinati contesti.

Il Markdown originale, creato da John Gruber nel 2004, era volutamente minimale. Con l’aumento della sua popolarità, però, molte piattaforme hanno iniziato ad estenderlo per supportare funzionalità come tabelle, evidenziazione del codice, checkbox, e altro ancora.

Varianti comuni:

• GitHub Flavored Markdown (GFM): usato su GitHub, supporta tabelle, task list, evidenziazione del codice e altro
• CommonMark: uno standard che mira a rendere il Markdown più coerente e prevedibile.
• Markdown Extra: include estensioni come tabelle, note a piè di pagina e definizioni.

RMarkdown è una variante. Consulta: RMarkdown cheatsheet

Di conseguenza, se alcuni elementi di sintassi non funzionano nel vostro documento, le cause possibili sono due:

• quella caratteristica (ad esempio l'evidenziazione del testo) non è supportata;
• oppure è supportata, ma con una sintassi diversa da quella che avete trovate, o che conoscete.

Quelli che seguono, funzionano ovunque.

NOTA: RStudio include un editor visuale di testi in markdown, che ha menu e comandi da tastiera per formattare il testo, inserire blocchi di codice, tabelle, note, e altro.

Per andare a capo, cioè per avere un nuovo paragrafo, bisogna lasciare una riga vuota. Altrimenti il testo viene scritto a seguire.

Questa è una riga,
ma questo testo in markdown continua nella stessa riga del precedente.
 
Questo invece è un nuovo paragrafo

Risultato:

Questa è una riga, ma questo testo in markdown continua nella stessa riga del precedente.

Questo invece è un nuovo paragrafo

vedi Basi di RMarkdown: i blocchi di codice

vedi Markdown: le tabelle

vedi Markdown: i riferimenti bibliografici