Markdown consente di scrivere testi formattati utilizzando una sintassi semplice e facilmente leggibile.
Viene utilizzato in vari contesti, come la scrittura di documentazione tecnica, blog, README files su piattaforme come GitHub, e anche per creare contenuti in sistemi di gestione dei contenuti (CMS) o piattaforme di blogging come Jekyll e Hugo.
Markdown serve per semplificare la scrittura di documenti formattati, permettendo agli utenti di concentrarsi sul contenuto senza doversi preoccupare della complessità del codice. La sua sintassi intuitiva lo rende ideale per scrivere in modo rapido e strutturato, ed è facilmente convertibile in HTML o altri formati, rendendolo perfetto per la pubblicazione su web o la condivisione di documenti tecnici in modo efficiente.
Generalmente, visualizzare immediatamente la resa di un testo in Markdown non è difficile, ma nel nostro caso non è immediato…
Intanto usiamo questo: https://markdownlivepreview.com/
Per rendere una frase in corsivo in Markdown, puoi racchiudere le parole con un trattino basso _.
Una parola _in corsivo_.
Una parola in corsivo.
Allo stesso modo, per rendere una frase in grassetto in Markdown, puoi racchiudere le parole con due asterischi **.
Una parola **in grassetto**.
Una parola in grassetto.
Naturalmente, puoi usare sia il corsivo che il grassetto nella stessa riga. Puoi anche applicarli su più parole.
In generale, non importa in quale ordine metti gli asterischi o i trattini bassi.
In Markdown, le intestazioni sono precedute da uno o più cancelletti #.
Esistono sei livelli di intestazioni in Markdown:
# Intestazione 1
## Intestazione 2
### Intestazione 3
#### Intestazione 4
##### Intestazione 5
###### Intestazione 6
Esistono due tipi di link in Markdown (link inline e reference link), ma entrambi vengono visualizzati nello stesso modo.
Per creare un link inline, racchiudi il testo del link tra parentesi quadre [ ].
Poi racchiudi l’URL tra parentesi tonde ( ).
Link al mio [sito](https://sbrzt.netlify.app).
Link al mio sito.
Per trasformare rapidamente un URL o un indirizzo email in un link, racchiudilo tra caporali < >.
<sebastian.barzaghi2@unibo.it>
L’altro tipo di link si chiama reference link, poiché fa riferimento a un altro punto nel documento.
Ecco [un link a qualcos'altro][altro luogo].
Ecco [un altro link][altro-link].
E ora torniamo a [primo link][altro luogo].
[altro luogo]: www.github.com
[altro-link]: www.google.com
Ecco un link a qualcos’altro.
Ecco un altro link.
E ora torniamo a primo link.
Per linkare ad un altro elemento (di solito un’intestazione) all’interno dello stesso documento, è sufficiente riprendere il testo dell’intestazione in minuscolo, sostituire gli eventuali spazi con il trattino -, e precederlo con il cancelletto #.
###### Intestazione sei
[Link all'intestazione sei](#intestazione-sei)
Se sai come creare link in Markdown, puoi creare anche immagini. La sintassi è quasi la stessa.
Per creare un’immagine, inserisci un punto esclamativo !, racchiudi il testo alternativo tra parentesi quadre [ ], e poi racchiudi il link dell’immagine tra parentesi tonde ( ) (Il testo alternativo è una frase o una frase che descrive l’immagine per le persone con disabilità visive).
Per creare una citazione, tutto quello che devi fare è precedere la linea con il simbolo “maggiore di” >.
> Questa è una citazione.
Questa è una citazione.
Esistono due tipi di liste: ordinate e non ordinate.
Per creare una lista non ordinata, precedi ogni elemento della lista con un asterisco *, seguito da uno spazio. Ogni elemento della lista deve essere su una propria linea.
* Primo elemento
* Secondo elemento
* Terzo elemento
Una lista ordinata è preceduta da numeri, anziché asterischi.
1. Primo elemento
2. Secondo elemento
3. Terzo elemento
A volte, potresti aver bisogno di annidare una lista all’interno di un’altra.
La sintassi è uguale, con l’aggiunta di quattro spazi (o un tab) prima dell’asterisco o numero dell’elemento indentato.
In alcune variazioni di Markdown, è sufficiente uno spazio.
* Primo elemento
* Secondo elemento
* Terzo elemento
I paragrafi sono delimitati dal newline (a capo + invio).
Primo paragrafo.
Secondo paragrafo.
Primo paragrafo.
Secondo paragrafo.
Altrimenti, è possibile mantenere le righe vicine, ma separate da due spazi .
Primo paragrafo.
Secondo paragrafo.
Primo paragrafo.
Secondo paragrafo.
Per indicare un pezzo di testo come parte di un codice, racchiudilo tra backtick ```.
Questo è un pezzo di `codice`
QUesto è un pezzo di codice.
Per creare blocchi di codice, indenta ogni linea del blocco di almeno quattro spazi o un tab.
Questo è un blocco di codice
che continua per molteplici
righe.
Per creare un separatore orizzontale (una linea, in pratica), usa tre o più asterischi ***, trattini --- o trattini bassi ___, da soli.
Per aggiungere una tabella, usa tre o più trattini (—) per creare l’intestazione di ogni colonna, e usa il simbolo pipe | per separare ogni colonna e definire l’inizio e la fine di ogni riga.
| Intestazione 1 | Intestazione 2 |
| ------------------------- | --------------- |
| Intestazione | Titolo |
| Paragrafo | Testo |
| Intestazione 1 | Intestazione 2 |
|---|---|
| Intestazione | Titolo |
| Paragrafo | Testo |
Synch fork > Update branch);data, create un nuovo file README.md;README.md, copia-incollate i contenuti dai README.txt;README.txt;pull request, come l’altra volta.data# Mythologiae - Data Management Plan
| Versione | Data | Note |
| -------- | ---------- | ----------------------- |
| v0.1.0 | 21-11-2024 | Creazione del documento |
## Autori
- Sebastian Barzaghi -- ORCID -- AFFILIAZIONE -- RUOLO
- ...
## Sommario esecutivo
...
## Introduzione
...
## Descrizione dei dati
- Quali dati (ad esempio il tipo, i formati e i volumi)
verranno raccolti o prodotti?
- Come verranno raccolti o prodotti i nuovi dati e/o
come verranno riutilizzati i dati esistenti?
## Documentazione e qualità dei dati
- Quali metadati e documentazione (ad esempio la metodologia
di raccolta dei dati e il modo di organizzare i dati)
accompagneranno i dati?
- Quali misure di controllo della qualità dei dati saranno
utilizzate?
## Backup e archiviazione
- Come saranno archiviati e salvati i dati e i metadati
durante la ricerca?
- Come sarà gestita la sicurezza dei dati e la protezione
dei dati sensibili durante la ricerca?
## Requisiti legali ed etici
- Come saranno gestite altre questioni legali, come i diritti
di proprietà intellettuale e la proprietà? Quale legislazione
si applica?
- Quali questioni etiche e codici di condotta ci sono e come
saranno presi in considerazione?
## Condivisione dei dati e conservazione a lungo termine
- Come e quando i dati saranno condivisi? Ci sono possibili
restrizioni alla condivisione dei dati o motivi di embargo?
- Come saranno selezionati i dati per la conservazione e dove
saranno conservati a lungo termine (ad esempio un repository
di dati o un archivio)?
- Quali metodi o strumenti software sono necessari per accedere
e utilizzare i dati?
- Come sarà garantita l'applicazione di un identificatore unico
e persistente (come un Digital Object Identifier, o DOI) a
ciascun set di dati?
docs