Il Markdown è un linguaggio di markup leggero, progettato per semplificare la formattazione del testo in modo rapido e intuitivo. Creato per rendere più semplice e leggibile la formattazione de testo rispetto ad altri linguaggi comunemente usati come HTML. Permette infatti di focalizzarsi maggiormente sul contenuto piuttosto che la codifica.
Il termine “Markdown” deriva dall’idea di “contrassegnare” i file come si farebbe con i documenti cartacei per renderli leggibile e organizzati.
Il markdown viene utilizzato in molti contesti come ad esempio nei forum oppure nei sistemi di gestioni dei contenuti.
Come utilizzare il markdown#
È importante conoscere il sistema di linguaggio del markdown, per poterne scoprire le piene potenzialità. Potrai mantenere un testo pulito e organizzato utilizzando testo e simboli.
- Semplice
- Leggibile
- Portabilità
Il markdown ha una sintassi semplice, è quindi facile da imparare, può essere convertito facilmente in HTML rendendolo perfetto per essere utilizzato sul web.
Titoli e sottotitoli#
Per crearli ti basterà utilizzare il simbolo # seguito da spazio ed inserendo il testo.
# Il mio titolo
#### Il mio sottotitolo
Il numero di # determina la grandezza del titolo.
Nell’esempio appena mostrato, vedrai questo:
Il mio titolo#
Il mio sottotitolo#
Formattazione del testo#
- Grassetto
Per rendere il testo in grassetto si possono utilizzare due modi:
- utilizzando
**testo in grasseto** - utilizzando
__testo in grassetto__
- Corsivo
Il corsivo è molto simile al grassetto, si utilizza peró una volta uno dei due simboli in questo modo:
*testo in corsivo*_testo in corsivo_
Vediamo un esempio pratico di quello che abbiamo imparato fino adesso:
## Imparando Markdown
I miei pensieri per questo *linguaggio di testo*, il **Markdwon**!
### Testo
Adesso so come scrivere in _corsivo_ e in __grassetto__.
Verrà visualizzato in questo modo:
Imparando Markdown#
I miei pensieri per questo linguaggio di testo, il Markdwon!
Adesso sappiamo come scrivere in corsivo e in grassetto. Vediamo insieme come creare gli elenchi puntati e delle liste.
- Elenco puntato
Abbiamo ben tre opzioni per poter utilizzare l’elenco puntato all’interno di un file markdown.
Utilizzando *, il + oppure -.
La mia lista della spesa:
- uova
- pane
- latte
- pomodori
Il risultato:
La mia lista della spesa:
- uova
- pane
- latte
- pomodori
- Elenco numerato
Il mio elenco numerato con sotto elemento
1. Elemento 1
2. Elemento 2
3. Elemento 3
1. Sotto elemento 1
2. Sotto elemento 2
Risultato:
Il mio elenco numerato con sotto elemento
Elemento 1
Elemento 2
Elemento 3
- Sotto elemento 1
- Sotto elemento 2
Inserire citazioni in markdown
> Qui il testo della citazione
Risultato:
Qui il testo della citazione
- Link ipertestuali
[il mio link](url di riferimento)
Risultato:
- Immagini con url
La differenza tra l’inserimento di una immagine e un link ipertestuale sta nel simbolo !. Dovrai infatti utilizzarlo solo per le immagini.
Per inserire una immagine all’interno di una cartella, dovrai inserire la directory che contiene l’immagine.
Estensioni Markdown#
Abbiamo appena visto come strutturare il testo di base in markdown. Ora vedremo in che modo le estensioni ci permettono di espandere le capacità di formattazione di questo linguaggio. Utili per presentare tabelle, blocchi di codice, note, separatori e tanto altro.
Tabelle#
Le tabelle sono molto utili per organizzare dati in formato tabellare. Basterà utilizzare - per definire le colonne e pipe e invece | per separare una colonna dall’altra.
| Gennaio | Febbraio | Marzo | Aprile | Maggio |
|---------|----------|--------|---------|---------|
| Entrate |Entrate | Entrate| Entrate | Entrate |
| Uscite | Uscite | Uscite | Uscite | Uscite |
Risultato:
| Gennaio | Febbraio | Marzo | Aprile | Maggio |
|---|---|---|---|---|
| Entrate | Entrate | Entrate | Entrate | Entrate |
| Uscite | Uscite | Uscite | Uscite | Uscite |
Blocchi di codice#
In markdown è possibile mostrare i blocchi di codice di esempi. Puoi utilizzare questo sistema con qualsiasi codice utilizzando: ``` e il nome del blocco come ad esempio python. Vediamo un esempio:
```python
def hello_world():
print("Hello, Wordl!")
Alla fine del blocco inserire sempre i caratteri di chiusura ```.
Avremo quindi questo risultato:
def hello_world():
print("Hello, Wordl!")
Note a piè di pagina#
Utili per fornire informazioni aggiuntive senza interrompere la lettura del testo principale. In markdown, le note a piè di pagina si creano utilizzando una sintassi estesa. Ecco un esempio:
Questo è un testo con nota a piè di pagina. [^1]
Questo è un altro testo con una nota. [^2]
[^1]: Questa è l'informazione aggiuntiva alla nota a piè di pagina
[^2]: Questa è la seconda informazione aggiuntiva
Facciamo un piccolo riepilogo di quanto appreso fino ad ora, creando un piccolo documento fittizzio.
# Documento di Esempio in Markdown
## Introduzione
Benvenuti nel nostro documento di esempio in Markdown! In questo documento, esploreremo varie funzionalità di Markdown per formattare il testo in modo chiaro e leggibile.
### Cosa troverai in questo documento
1. [Titoli e Sottotitoli](#titoli-e-sottotitoli)
2. [Formattazione del Testo](#formattazione-del-testo)
3. [Elenchi](#elenchi)
4. [Citazioni](#citazioni)
5. [Link e Immagini](#link-e-immagini)
## Titoli e Sottotitoli
I titoli e i sottotitoli sono utili per strutturare il documento e rendere chiaro il contenuto.
### Titoli di diversi livelli
Utilizziamo il simbolo `#` seguito dal testo per creare titoli di diversi livelli:
# Titolo di Primo Livello
## Titolo di Secondo Livello
### Titolo di Terzo Livello
#### Titolo di Quarto Livello
##### Titolo di Quinto Livello
###### Titolo di Sesto Livello
## Formattazione del Testo
Markdown offre diverse opzioni per formattare il testo.
**Grassetto**
Puoi rendere il testo in grassetto utilizzando `**testo in grassetto**` o `__testo in grassetto__`.
*Corsivo*
Puoi rendere il testo in corsivo utilizzando `*testo in corsivo*` o `_testo in corsivo_`.
**Grassetto e Corsivo**
Puoi combinare entrambe le formattazioni utilizzando `***testo in grassetto e corsivo***` o `___testo in grassetto e corsivo___`.
### Esempi di Formattazione
**Questo testo è in grassetto**
*Questo testo è in corsivo*
***Questo testo è in grassetto e corsivo***
## Elenchi
Gli elenchi sono utili per elencare punti o passaggi.
### Elenchi Puntati
- Punto 1
- Punto 2
- Sotto-punto 2.1
- Sotto-punto 2.2
### Elenchi Numerati
1. Passo 1
2. Passo 2
3. Passo 3
1. Sotto-passo 3.1
2. Sotto-passo 3.2
## Citazioni
Le citazioni possono essere utilizzate per evidenziare testo importante o citare fonti.
> Questa è una citazione significativa.
## Link e Immagini
Puoi inserire link e immagini nei tuoi documenti Markdown.
### Link Ipertestuali
[Link a Google](https://www.google.com)
### Immagini con URL
## Note a Piè di Pagina
Utili per fornire informazioni aggiuntive senza interrompere la lettura del testo principale.
Questo è un esempio di nota a piè di pagina.[^1]
[^1]: Questa è l'informazione aggiuntiva alla nota a piè di pagina.
Copia e incolla questo codice nel tuo editor di testo per vedere il risultato!
Continua nella seconda parte