Quando si parla di intelligenza artificiale, documentazione digitale, appunti, manuali o istruzioni operative, capita sempre più spesso di incontrare una sigla apparentemente tecnica: MD.
Un file .md è un file scritto in Markdown, un sistema semplice per dare struttura a un testo usando normali caratteri della tastiera.
La parola può sembrare complicata, ma l’idea è molto semplice: Markdown permette di scrivere documenti ordinati senza usare programmi complessi come Word, senza impaginazioni pesanti e senza elementi nascosti difficili da gestire.
Un file Markdown è, prima di tutto, un normale file di testo. La differenza è che usa alcuni simboli per indicare titoli, elenchi, link, immagini, grassetti, citazioni, tabelle e blocchi di codice o di esempio.
Per esempio:
</> Markdown
# Titolo principale
Questo è un paragrafo.
– Primo punto
– Secondo punto
– Terzo punto
Anche chi non conosce Markdown riesce comunque a capire il contenuto. Questo è uno dei suoi grandi vantaggi: resta leggibile sia per gli esseri umani sia per le macchine ed è proprio per questo che oggi il Markdown è diventato molto interessante anche nel rapporto con l’intelligenza artificiale.
Perché si usano i file Markdown
I file Markdown si usano perché sono semplici, leggeri, ordinati e facili da riutilizzare.
Un documento Word contiene molte informazioni nascoste: font, stili, margini, interlinee, colori, formattazioni, dati interni al file. Tutto questo è utile quando dobbiamo preparare un documento graficamente rifinito, ma può diventare inutile o scomodo quando vogliamo solo conservare, trasmettere o far leggere delle istruzioni.
Markdown, invece, conserva quasi solo ciò che conta davvero: testo e struttura.
Questo lo rende adatto a molti usi:
scrivere appunti;
preparare guide;
creare manuali;
documentare procedure;
scrivere articoli;
organizzare prompt;
preparare istruzioni per l’AI;
creare piccole “skill” o procedure riutilizzabili;
mantenere testi facilmente modificabili nel tempo.
Un file Markdown può essere aperto con un editor di testo semplice, copiato facilmente, letto da molti programmi, pubblicato sul web e interpretato bene anche dai sistemi di intelligenza artificiale.
In pratica, Markdown è utile quando vogliamo separare il contenuto dalla grafica.
Prima scriviamo bene il contenuto.
Poi, eventualmente, qualcuno o qualcosa si occuperà di mostrarlo in modo più bello.
Markdown non è programmazione
Una cosa importante va chiarita subito: Markdown non è un linguaggio di programmazione.
Non serve a creare programmi, applicazioni o software. Serve a scrivere testi strutturati.
È più simile a un modo ordinato di prendere appunti che a un linguaggio informatico.
Quando scriviamo:
</> Markdown
# Capitolo 1
non stiamo dando un comando al computer. Stiamo solo creando un elenco puntato.
Questa semplicità rende Markdown molto adatto anche a chi viene dal mondo delle scienze umanistiche, della scrittura, dell’insegnamento, della comunicazione o della ricerca.
Perché Markdown è utile con l’intelligenza artificiale
L’intelligenza artificiale lavora meglio quando riceve informazioni chiare, ordinate e ben separate.
Un testo confuso, pieno di parti mescolate, rende più difficile ottenere una buona risposta. Un testo organizzato con titoli, elenchi e sezioni chiare, invece, aiuta l’AI a capire meglio cosa deve fare.
Per questo Markdown è molto utile.
Possiamo usarlo per scrivere file come:
istruzioni_per_scrivere_email.md
procedura_per_riordinare_appunti.md
Dentro questi file possiamo inserire istruzioni operative, per esempio:
</> Markdown
# Skill: Riordino appunti
## Scopo
Trasformare appunti disordinati in un testo chiaro.## Procedura
1. Leggi tutto il materiale.
2. Individua le idee principali.
3. Elimina le ripetizioni.
4. Organizza il testo in ordine logico.
5. Riscrivi in modo semplice.Regole
– Non inventare informazioni.
– Non cambiare il significato originale.
– Segnala eventuali punti poco chiari.
Questo tipo di file può essere dato a un sistema di AI per spiegargli come vogliamo che lavori. Non è una vera “skill” tecnica nel senso stretto del termine, ma può funzionare come una procedura riutilizzabile.
Invece di riscrivere ogni volta le stesse istruzioni, possiamo prepararle una volta in un file .md e usarle quando servono.
Le caratteristiche principali del Markdown
Vediamo ora le regole più importanti per scrivere un file Markdown.
Non serve impararle tutte subito. Per cominciare bastano titoli, paragrafi, elenchi e grassetto. Le altre si possono aggiungere con il tempo.
1. L’estensione del file
Un file Markdown di solito termina con l’estensione:
.md
Per esempio:
guida.md
appunti.md
2. I titoli
I titoli si scrivono usando il cancelletto #.
</> Markdown
# Titolo principale
## Titolo di secondo livello
### Titolo di terzo livello
#### Titolo di quarto livello
Un solo # indica il titolo principale.
Due ## indicano una sezione.
Tre ### indicano una sottosezione.
È come costruire l’indice di un libro:
È come costruire l’indice di un libro:
</> Markdown
# Capitolo
## Paragrafo
### Sottoparagrafo
Questa struttura è molto importante perché aiuta il lettore a orientarsi e aiuta anche l’intelligenza artificiale a capire la gerarchia delle informazioni.
3. I paragrafi
In Markdown, per separare due paragrafi, basta lasciare una riga vuota.
</> Markdown
Questo è il primo paragrafo.
Questo è il secondo paragrafo.
La riga vuota indica che un blocco di pensiero è finito e ne comincia un altro.
È una regola semplice, ma molto importante. Un testo senza separazione tra i paragrafi diventa subito più difficile da leggere.
4. Gli elenchi puntati
Gli elenchi puntati si scrivono usando il trattino -.
</> Markdown
– Primo punto
– Secondo punto
– Terzo punto
Gli elenchi puntati sono utili per indicare:
caratteristiche;
esempi;
materiali necessari;
cose da ricordare;
regole;
opzioni alternative.
Per esempio:
</> Markdown
Questa procedura serve per:
– riordinare appunti;
– eliminare ripetizioni;
– chiarire i concetti principali;
– preparare un testo finale leggibile.
5. Gli elenchi numerati
Gli elenchi numerati si scrivono usando i numeri.
</> Markdown
1. Leggi il testo.
2. Individua le idee principali.
3. Elimina le ripetizioni.
4. Riscrivi in modo chiaro.
Gli elenchi numerati sono utili quando i passaggi devono essere seguiti in ordine.
Per questo sono fondamentali nei file Markdown usati come procedure per l’AI.
Una lista numerata dice chiaramente:
prima fai questo, poi questo, poi quest’altro.
6. Il grassetto
Il grassetto si ottiene mettendo due asterischi prima e dopo la parola o la frase.
</> Markdown
**testo in grassetto**
Esempio:
</> Markdown
Questa è una **regola obbligatoria**.
Il grassetto serve per evidenziare un concetto importante, ma va usato con moderazione. Se tutto è in grassetto, nulla risalta davvero.
7. Il corsivo
Il corsivo si ottiene mettendo un solo asterisco prima e dopo la parola o la frase.
</> Markdown
*testo in corsivo*
Esempio:
</> Markdown
Questa è una spiegazione *semplificata*.
Il corsivo può essere utile per dare enfasi leggera a una parola o per indicare un termine particolare.
8. Il barrato
In molti sistemi Markdown è possibile barrare una parola usando due tilde ~~.
</> Markdown
~~testo barrato~~
Esempio:
</> Markdown
Questa frase è ~~da eliminare~~ da correggere.
Non tutti gli ambienti Markdown lo supportano allo stesso modo, ma è molto comune.
9. I link
I link si scrivono così:
</> Markdown
[Testo visibile](https://www.esempio.it)
La parte tra parentesi quadre è il testo che il lettore vedrà.
La parte tra parentesi tonde è l’indirizzo del sito.
Esempio:
</> Markdown
Visita il sito di [Loquendum](https://www.loquendum.it).
Questo sistema è più elegante che incollare un indirizzo lungo dentro il testo.
Invece di scrivere:
Vai su https://www.loquendum.it per leggere altri articoli.
possiamo scrivere:
</> Markdown
Vai su [Loquendum](https://www.loquendum.it) per leggere altri articoli.
10. Le immagini
Le immagini si inseriscono in modo simile ai link, ma con un punto esclamativo all’inizio.
</> Markdown
La descrizione tra parentesi quadre spiega che cosa rappresenta l’immagine.
La parte tra parentesi tonde indica dove si trova l’immagine.
Ci sono tre possibilità principali.
Immagine nella stessa cartella
Se il file Markdown e l’immagine sono nella stessa cartella possiamo scrivere:
</> Markdown
Immagine in una sottocartella
Se l’immagine è in una sottocartella scriveremo:
</> Markdown
Immagine online
Se l’immagine è già online, possiamo usare direttamente l’URL:
</> Markdown
In questo caso il file Markdown non contiene l’immagine, ma solo il collegamento.
C’è però un rischio: se l’immagine viene rimossa dal sito o cambia indirizzo, non sarà più visibile.
Per questo, quando l’immagine è importante, conviene conservarla insieme al file Markdown o in una sottocartella dedicata.
11. Le citazioni
Le citazioni si fanno usando il simbolo >.
</> Markdown
> Questa è una citazione.
Esempio:
</> Markdown
> Una skill non deve solo informare: deve guidare un’azione.
Le citazioni sono utili per distinguere una frase importante, una definizione, un passaggio preso da un altro testo o una nota da mettere in evidenza.
12. Il codice breve e i backtick
In Markdown esiste un simbolo particolare chiamato backtick.
È questo:
`
Non è un punto e non è un apostrofo normale.
Serve per evidenziare parole tecniche, nomi di file, simboli, comandi o piccoli pezzi di codice.
Esempio:
</> Markdown
Il file deve chiamarsi `skill_appunti.md`.
Sulle tastiere italiane può essere più difficile da trovare. Su Windows si può ottenere spesso con:
Alt + 96
cioè tenendo premuto Alt, digitando 96 sul tastierino numerico e poi rilasciando Alt.
In alternativa, il metodo più semplice è copiarlo e incollarlo.
13. I blocchi di codice o di esempio
Se vogliamo inserire un blocco più lungo di codice, testo tecnico o esempio, usiamo tre backtick all’inizio e tre alla fine.
Esempio:
</> Markdown
“`txt
Questo è un blocco di esempio.
“`
Oppure:
</> Markdown
“`json
{
“nome”: “Mario”,
“ruolo”: “docente”
}
“`
I blocchi di codice non servono solo ai programmatori. Sono utili anche per mostrare esempi di prompt, modelli, template, istruzioni o testi da copiare.
14. Le tabelle
Markdown permette anche di creare tabelle.
</> Markdown
| Elemento | Funzione |
|—|—|
| # | Titolo principale |
| – | Elenco puntato |
| 1. | Elenco numerato |
| **testo** | Grassetto |
| [link](url) | Collegamento |
Una tabella può essere utile per confrontare informazioni o riassumere regole.
Per esempio:
</> Markdown
| Simbolo | Significato |
|—|—|
| # | Titolo |
| – | Elenco puntato |
| ** ** | Grassetto |
| > | Citazione |
| ` ` | Codice breve |
Le tabelle però vanno usate con moderazione. Nei file destinati all’intelligenza artificiale spesso funzionano meglio titoli chiari, elenchi puntati e procedure numerate.
15. Le linee orizzontali
Una linea orizzontale si può creare con tre trattini, serve per separare due parti del documento.
Esempio:
</> Markdown
Prima parte del testo.
—
Seconda parte del testo.
È utile quando vogliamo dividere sezioni molto diverse tra loro.
16. Le checklist
Alcuni sistemi Markdown permettono di creare liste di controllo.
</> Markdown
– [ ] Primo compito da fare
– [ ] Secondo compito da fare
– [x] Compito già completato
Esempio:
## Checklist finale
– [ ] Il testo è chiaro?
– [ ] Le ripetizioni sono state eliminate?
– [ ] Le informazioni importanti sono rimaste?
– [ ] Il risultato finale è coerente?
Le checklist sono molto utili nelle procedure operative, soprattutto quando vogliamo usare un file Markdown come guida per l’AI o per un collaboratore umano.
17. Andare a capo
In Markdown, andare a capo una sola volta non sempre crea un nuovo paragrafo. Per creare un nuovo paragrafo è meglio lasciare una riga vuota.
Corretto:
</> Markdown
Questo è il primo paragrafo.
Questo è il secondo paragrafo.
Meno chiaro:
</> Markdown
Questo è il primo paragrafo.
Questo è il secondo paragrafo.
18. I caratteri speciali
A volte vogliamo mostrare un simbolo Markdown senza farlo interpretare.
Per esempio, vogliamo scrivere # senza creare un titolo.
In questi casi si può usare la barra inversa \.
</> Markdown
\# Questo non diventa un titolo
La barra inversa dice al sistema: “tratta il simbolo come semplice testo”.
19. Il front matter
In alcuni siti o generatori di pagine web, i file Markdown possono contenere una parte iniziale chiamata front matter.
Di solito è scritta tra tre trattini:
</> Markdown
—
title: “Titolo dell’articolo”
description: “Breve descrizione dell’articolo”
date: “2026-05-12”
—
Questa parte serve a fornire informazioni sul documento: titolo, descrizione, data, autore, categoria o altri dati utili al sistema che pubblica il contenuto.
Non è obbligatoria nel Markdown normale, ma è molto usata nei siti statici, nei blog tecnici e in alcuni CMS.
Markdown come metodo di lavoro
Il Markdown non è importante solo perché permette di scrivere titoli o elenchi. È importante perché incoraggia un modo di pensare più ordinato.
Quando scriviamo in Markdown, siamo spinti a dividere il testo in sezioni, a distinguere i concetti principali da quelli secondari, a usare elenchi quando servono, a separare gli esempi dalle spiegazioni.
Questo è utile per chi scrive.
È utile per chi legge.
Ed è utile anche per l’intelligenza artificiale.
Un file Markdown ben scritto può diventare:
una guida;
un manuale;
una scaletta;
un prompt avanzato;
una procedura;
una checklist;
una base di conoscenza;
una piccola “skill” da dare a un sistema AI.
Per esempio, invece di dire ogni volta all’AI:
Riscrivi questi appunti in modo ordinato, senza cambiare il senso, eliminando le ripetizioni e segnalando eventuali dubbi.
possiamo creare un file:
skill_riordino_appunti.md
e scrivere dentro:
</> Markdown
# Skill: Riordino appunti
## Scopo
Trasformare appunti disordinati in un testo chiaro e ordinato.## Procedura
1. Leggi tutto il materiale.
2. Individua il tema principale.
3. Separa le idee principali da quelle secondarie.
4. Elimina le ripetizioni inutili.
5. Riscrivi in modo chiaro.
6. Segnala eventuali punti ambigui.## Regole
– Non inventare informazioni.
– Non modificare il significato originale.
– Non eliminare concetti importanti.Output
Restituisci:
1. Testo ordinato.
2. Punti principali.
3. Dubbi o informazioni mancanti.
A questo punto il file Markdown non è più solo un documento. Diventa una procedura riutilizzabile.
Articolo o procedura?
C’è una differenza importante.
Un articolo spiega un argomento una procedura dice come svolgere un compito.
Per esempio, questo è l’inizio di un articolo:
</> Markdown
# L’importanza di prendere buoni appunti
Prendere appunti è fondamentale perché aiuta a ricordare meglio le informazioni…
Questo, invece, è l’inizio di una procedura:
</> Markdown
# Procedura per riordinare appunti
## Quando usarla
Usa questa procedura quando il testo è confuso, incompleto o disordinato.Passaggi
1. Leggi tutto il testo.
2. Trova le idee principali.
3. Elimina le ripetizioni.
4. Riorganizza il contenuto.
Entrambi possono essere scritti in Markdown, ma hanno scopi diversi.
Il primo informa.
Il secondo guida un’azione.
Questa distinzione è molto importante quando usiamo Markdown con l’intelligenza artificiale.
Riassumendo
Markdown è un modo semplice per scrivere documenti strutturati usando normali caratteri della tastiera.
Non è programmazione.
Non richiede competenze tecniche avanzate.
Non serve un software complicato.
Serve soprattutto a scrivere testi chiari, ordinati e facilmente riutilizzabili.
Con Markdown possiamo creare titoli, paragrafi, elenchi, link, immagini, citazioni, tabelle, checklist e blocchi di esempio.
Ma il suo valore maggiore, oggi, sta nel fatto che è un formato ideale per lavorare con l’intelligenza artificiale.
Un file .md può diventare una guida, una procedura, un prompt avanzato o una piccola skill operativa. Può spiegare all’AI non solo cosa vogliamo ottenere, ma anche come vogliamo che lavori.
In un mondo in cui useremo sempre più spesso sistemi di intelligenza artificiale, imparare a scrivere bene un file Markdown significa imparare a organizzare meglio il pensiero.
E questa, alla fine, non è una competenza tecnica.
È una competenza culturale.
