Markdown è un linguaggio semplice progettato per semplificare la scrittura di contenuti. È utilizzato ovunque, da GitHub alle applicazioni di note. Se sei uno scrittore, uno sviluppatore, o semplicemente qualcuno che vuole semplificare la tua scrittura web, questa guida è per te!
Markdown è un linguaggio di markup leggero, creato da John Gruber nel 2004, per rendere il testo formattato facilmente leggibile negli editor di testo semplice. È particolarmente popolare per il blogging, la messaggistica istantanea, i forum, gli strumenti collaborativi, la documentazione e i file readme. Nel tempo, variazioni nella sua interpretazione hanno portato alla creazione di CommonMark nel 2014, una specifica più chiara con un insieme di test per assicurare un’implementazione coerente.
Ecco una rapida panoramica degli elementi più comuni che utilizzerai:
Le intestazioni vengono create utilizzando il simbolo #
, seguito da uno spazio:
# Questo è un H1
## Questo è un H2
### Questo è un H3
Per l’italic, usa *asterischi*
o _underscore_
.
Per il grassetto, usa **doppi asterischi**
o __doppi underscore__
.
Usa asterischi, più, o meno seguiti da uno spazio:
* Elemento 1
* Elemento 2
* Sotto-elemento 2.1
* Sotto-elemento 2.2
Usa semplicemente numeri seguiti da punti:
1. Primo elemento
2. Secondo elemento
3. Terzo elemento
Puoi creare un link inline con la seguente sintassi:
[Testo mostrato](URL "Titolo opzionale")
Le immagini sono simili ai link ma con un punto esclamativo davanti:
![Testo alternativo](URL "Titolo opzionale")
Per le citazioni, usa il carattere >
prima del tuo testo:
> Questa è una citazione.
Per il codice inline
, circonda il tuo codice con backticks:
`il codice va qui`
Per blocchi di codice multilinea, usa tre backticks:
\```
Riga 1 di codice
Riga 2 di codice
Riga 3 di codice
\```
Puoi creare una linea orizzontale con tre trattini, asterischi o underscore:
---
| Intestazione1 | Intestazione2 |
|--------------|--------------|
| cella1 | cella2 |
| cella3 | cella4 |
- [x] Task completato
- [ ] Task non completato
Usa ~~
per barrare il testo:
~~barrato~~
Nel tuo file Markdown, puoi aggiungere citazioni usando il simbolo @
seguito dalla chiave di citazione. Ad esempio:
Secondo studi recenti [@Smith2023], l'effetto è...
Puoi anche usare più citazioni:
Alcuni ricercatori sostengono questo punto [@Smith2023; @Doe2022].
Le citazioni tra parentesi (o incorporate nel testo) posizionano l’autore e l’anno tra parentesi:
Questo fenomeno è stato osservato in diversi contesti (ad esempio, [@Smith2023]).
Le citazioni narrative integrano l’autore direttamente nella frase:
Secondo @Smith2023, il fenomeno...
Per creare e gestire la tua bibliografia, raccomandiamo di utilizzare CiteDrive. CiteDrive è un gestore di riferimenti BibTeX basato sul cloud, progettato specificamente per gli utenti di Overleaf, LaTeX e R Markdown. Semplifica il processo di conservazione e esportazione delle citazioni nel formato .bib
.
Ecco una voce BibTeX che potresti avere nel tuo file .bib
:
@article{Smith2023,
title = {Titolo dello studio},
author = {Smith, Giovanni},
year = 2023,
journal = {Nome della rivista},
volume = 5,
pages = {10--20}
}