| LICENSE.md | ||
| README.md | ||
Guida Markdown in Italiano
Una guida completa per imparare a scrivere documenti in Markdown, con esempi pratici e riferimenti rapidi.
Indice
- Cos'è Markdown
- Sintassi Base
- Intestazioni
- Formattazione Testo
- Liste
- Link
- Immagini
- Codice
- Tabelle
- Citazioni
- Linee Orizzontali
- Task Lists
- Emoji
- Riferimenti Avanzati
Cos'è Markdown
Markdown è un linguaggio di markup leggero creato da John Gruber nel 2004. Permette di formattare testo in modo semplice e leggibile, convertibile facilmente in HTML.
Vantaggi:
- Facile da leggere anche in formato grezzo
- Veloce da scrivere
- Convertibile in HTML, PDF e altri formati
- Supportato da Forgejo, Gitea, GitHub, GitLab e molte altre piattaforme
Sintassi Base
Intestazioni
Uso il simbolo # per creare intestazioni. Più simboli = livello più basso.
# Intestazione H1
## Intestazione H2
### Intestazione H3
#### Intestazione H4
##### Intestazione H5
###### Intestazione H6
Risultato:
Intestazione H1
Intestazione H2
Intestazione H3
Intestazione H4
Intestazione H5
Intestazione H6
Formattazione Testo
**Grassetto** o __grassetto__
*Corsivo* o _corsivo_
***Grassetto e corsivo***
~~Testo barrato~~
Risultato:
Grassetto o grassetto
Corsivo o corsivo
Grassetto e corsivo
Testo barrato
Liste
Liste non numerate
- Elemento 1
- Elemento 2
- Sottoelemento 2.1
- Sottoelemento 2.2
- Elemento 3
Oppure con *:
* Elemento A
* Elemento B
* Sottoelemento B.1
Risultato:
- Elemento 1
- Elemento 2
- Sottoelemento 2.1
- Sottoelemento 2.2
- Elemento 3
Liste numerate
1. Primo elemento
2. Secondo elemento
3. Terzo elemento
1. Sottoelemento 3.1
2. Sottoelemento 3.2
Risultato:
- Primo elemento
- Secondo elemento
- Terzo elemento
- Sottoelemento 3.1
- Sottoelemento 3.2
Link
I link permettono di creare collegamenti cliccabili ad altre pagine o siti.
Link base
Come scrivere:
[Testo visibile](https://emanuelegori.uno)
Risultato:
Testo visibile ← Diventa un link cliccabile
Link con tooltip (titolo)
Come scrivere:
[Visita il mio blog](https://emanuelegori.uno "Passa il mouse per vedere il tooltip!")
Risultato:
Visita il mio blog ← Passa il mouse sopra
Link automatico (URL diretti)
Come scrivere:
<https://emanuelegori.uno>
<email@esempio.com>
Risultato:
https://emanuelegori.uno
email@esempio.com
Link con riferimento (utili per riutilizzo)
Come scrivere:
Visita [il mio blog][blog] o [il mio Gitea][git].
[blog]: https://emanuelegori.uno "Blog Emanuele Gori"
[git]: https://git.emanuelegori.uno "Gitea"
Risultato:
Visita il mio blog o il mio Gitea.
Link interni (ancore)
Come scrivere:
Vai alla sezione [Tabelle](#tabelle)
Risultato:
Vai alla sezione Tabelle ← Salta a quella sezione
Immagini
Le immagini funzionano come i link, ma con un ! davanti.
Immagine base
Come scrivere:
Risultato:
Immagine con titolo (tooltip)
Come scrivere:
Risultato:
Immagine con dimensioni personalizzate
Per controllare le dimensioni, uso HTML:
Come scrivere:
<img src="https://upload.wikimedia.org/wikipedia/commons/thumb/3/35/Tux.svg/200px-Tux.svg.png" alt="Tux" width="100">
Risultato:
Immagine cliccabile (immagine + link)
Come scrivere:
[](https://markdownguide.org)
Risultato:
Immagine con riferimento
Come scrivere:
![Tux][tux-logo]
[tux-logo]: https://upload.wikimedia.org/wikipedia/commons/thumb/3/35/Tux.svg/200px-Tux.svg.png "Logo Linux"
Risultato:
Immagini affiancate
Uso una tabella HTML per affiancare immagini:
Come scrivere:
<table>
<tr>
<td><img src="https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python"></td>
<td><img src="https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black" alt="JavaScript"></td>
</tr>
</table>
Risultato:
 |
 |
Codice
Codice inline
Uso `backtick` per il codice inline.
Risultato: Uso backtick per il codice inline.
Blocchi di codice
Uso tre backtick (```) per blocchi di codice, opzionalmente specifico il linguaggio:
```python
def saluta(nome):
print(f"Ciao {nome}!")
saluta("Mondo")
```
Risultato:
def saluta(nome):
print(f"Ciao {nome}!")
saluta("Mondo")
Linguaggi supportati: python, javascript, bash, html, css, php, sql, etc.
Tabelle
| Intestazione 1 | Intestazione 2 | Intestazione 3 |
|----------------|----------------|----------------|
| Cella 1 | Cella 2 | Cella 3 |
| Cella 4 | Cella 5 | Cella 6 |
Risultato:
| Intestazione 1 | Intestazione 2 | Intestazione 3 |
|---|---|---|
| Cella 1 | Cella 2 | Cella 3 |
| Cella 4 | Cella 5 | Cella 6 |
Allineamento colonne
| Sinistra | Centro | Destra |
|:---------|:------:|-------:|
| Testo | Testo | Testo |
| Altro | Altro | Altro |
Risultato:
| Sinistra | Centro | Destra |
|---|---|---|
| Testo | Testo | Testo |
| Altro | Altro | Altro |
Citazioni
> Questa è una citazione.
> Può estendersi su più righe.
>
> E avere paragrafi multipli.
Citazioni nidificate:
> Livello 1
>> Livello 2
>>> Livello 3
Risultato:
Questa è una citazione. Può estendersi su più righe.
E avere paragrafi multipli.
Linee Orizzontali
Uso tre o più trattini, asterischi o underscore:
---
***
___
Risultato:
Task Lists
- [x] Task completato
- [ ] Task da fare
- [ ] Altro task
- [x] Subtask completato
- [ ] Subtask da fare
Risultato:
- Task completato
- Task da fare
- Altro task
- Subtask completato
- Subtask da fare
Emoji
Gitea, GitHub e molte altre piattaforme supportano le emoji:
:smile: :heart: :+1: :rocket: :computer:
Risultato:
😄 ❤️ 👍 🚀 💻
Riferimenti Avanzati
Escape di caratteri
Uso il backslash \ per mostrare caratteri speciali letteralmente invece che interpretarli come Markdown.
Come scrivere:
\* Questo asterisco non crea una lista
\# Questo cancelletto non crea un'intestazione
\[Questo\](url) non crea un link
Risultato:
* Questo asterisco non crea una lista
# Questo cancelletto non crea un'intestazione
[Questo](url) non crea un link
Caratteri che possono essere "escaped":
\ backslash
` backtick
* asterisco
_ underscore
{} parentesi graffe
[] parentesi quadre
() parentesi tonde
# cancelletto
+ più
- meno
. punto
! punto esclamativo
HTML in Markdown
Posso usare HTML direttamente in Markdown per layout e formattazioni avanzate.
Come scrivere:
<div align="center">
<strong>Testo centrato e in grassetto</strong>
</div>
<details>
<summary>Clicca per espandere</summary>
Contenuto nascosto che appare solo quando clicchi sulla freccia
</details>
Risultato:
Clicca per espandere
Contenuto nascosto che appare solo quando clicchi sulla freccia
Usi comuni di HTML in Markdown:
<div align="center">- Centrare contenuti<details>- Creare sezioni espandibili<kbd>- Mostrare tasti della tastiera: Ctrl+C<sup>e<sub>- Apici e pedici: H2O, x2<mark>- Evidenziare testo (dove supportato)
Footnotes (Note a piè di pagina)
Le note a piè di pagina permettono di aggiungere riferimenti o note senza interrompere il flusso del testo.
Come scrivere:
Ecco una frase con una nota[^1]. Puoi continuare a scrivere[^2] normalmente.
Altra frase con riferimento[^nota-importante].
[^1]: Questa è la prima nota a piè di pagina.
[^2]: Questa è la seconda nota.
[^nota-importante]: Puoi usare anche nomi descrittivi per le note.
Risultato:
Ecco una frase con una nota1. Puoi continuare a scrivere2 normalmente.
Altra frase con riferimento3.
Nota: Le definizioni delle note possono essere scritte ovunque nel documento - appariranno sempre in fondo alla pagina renderizzata, nell'ordine in cui sono referenziate nel testo.
Risorse Utili
Licenza
Questa guida è rilasciata sotto licenza CC BY-NC-SA 4.0.
Uso non commerciale: Puoi usare, modificare e condividere questa guida liberamente per scopi non commerciali.
Uso commerciale: Per uso commerciale contatta l'autore su emanuelegori.uno.