Che cos’è un file .md? Una spiegazione semplice

Un file .md è un normale documento di testo scritto in uno stile chiamato Markdown. I simboli che contiene, come #, **, - e |, sono istruzioni sull’aspetto del testo: questa riga è un titolo, questa parola è in grassetto, queste righe sono un elenco. Un’app che capisce il Markdown nasconde i simboli e mostra la formattazione. Un’app che non lo capisce, come TextEdit, ti mostra i simboli.

Markdown in un paragrafo

La maggior parte dei documenti che conosci, come i file Word e i PDF, tiene la formattazione in uno strato nascosto che non vedi mai. Markdown fa il contrario: la formattazione è scritta nel testo stesso, con normali caratteri della tastiera. Il file è solo testo, quindi qualsiasi computer può aprirlo, non occupa quasi spazio e sarà ancora leggibile fra trent’anni. Il prezzo è che serve un’app che legga i simboli e li trasformi in formattazione, altrimenti li vedi così come sono.

Chi l’ha inventato e perché

Markdown è stato creato da John Gruber, autore del blog Daring Fireball, e pubblicato nel 2004, con un grande aiuto del programmatore Aaron Swartz. Gruber voleva un modo di scrivere per il web senza digitare HTML, e mise una regola sopra le altre: un documento Markdown deve essere leggibile così com’è, come testo semplice, senza sembrare coperto di istruzioni di formattazione.

Per questo i simboli furono presi da abitudini che le persone avevano già nelle email in testo semplice, come gli asterischi attorno a una parola per darle enfasi. Ecco perché un file .md grezzo, con tutto il suo disordine, resta in gran parte leggibile.

Altri hanno poi aggiunto ciò che all’originale mancava. La versione oggi più diffusa è GitHub Flavored Markdown, che ha introdotto tabelle, liste di controllo e testo barrato. Quando oggi si dice «Markdown», di solito si intende quella.

Perché le IA scrivono in Markdown

Quando ChatGPT, Claude, Gemini o Copilot ti risponde, il testo che scrive è di solito Markdown. Te ne accorgi di rado, perché la finestra della chat trasforma i simboli in titoli, grassetto e tabelle prima che tu li veda. Gli si addice: è compatto, sopravvive alla copia tra app ed è comune nel tipo di scrittura tecnica da cui questi strumenti hanno imparato.

I guai cominciano quando la risposta esce dalla chat. Chiedi «un file» e ottieni un .md: lo stesso testo, simboli compresi, senza nulla che li converta. Copia una risposta in un’app che non capisce il Markdown e gli asterischi la seguono.

Che cosa significano i simboli

Questi sono quelli che incontrerai in quasi ogni documento scritto da un’IA.

Quello che vedi nel file	Che cosa significa
`# Titolo`	Il titolo principale
`## Sezione`, `### Sottosezione`	Titoli più piccoli: più `#` ci sono, più piccolo è il titolo
`importante`	Grassetto: importante
`nota` oppure `_nota_`	Corsivo: nota
`- voce` oppure `* voce`	Un elenco puntato
`1. voce`	Un elenco numerato
`- [ ] da fare` e `- [x] fatto`	Una lista di controllo: una casella vuota e una spuntata
`[il rapporto](https://example.com)`	Un link: le parole tra parentesi quadre, l’indirizzo tra tonde
`> testo citato`	Una citazione, mostrata rientrata
`codice`	Un termine tecnico o un pezzetto di codice, in carattere da macchina da scrivere
Tre accenti gravi su una riga a sé	L’inizio o la fine di un blocco di codice
Righe di parole separate da barre verticali	Una tabella (vedi sotto)

Le tabelle sono la cosa più allarmante in forma grezza, quindi eccone una:

| Articolo | Prezzo |
| -------- | ------ |
| Caffè    | 3 €    |
| Torta    | 4 €    |

La prima riga è l’intestazione, la riga di trattini la separa dal resto e ogni riga successiva è una riga della tabella. Le barre segnano dove finisce una colonna e comincia la successiva. Mostrata come si deve, è una piccola tabella qualunque con due colonne e due righe.

Ogni tanto ne compaiono altri: ~~testo~~ per il barrato, --- su una riga a sé per una linea di separazione e ![descrizione](immagine.png) per un’immagine. Con questo è coperto quasi tutto.

Perché il Mac mostra i simboli

macOS non ha un lettore Markdown integrato. Per il sistema un file .md è testo semplice, quindi il doppio clic lo apre con l’app che gestisce il testo semplice, di solito TextEdit, o Xcode se sono installati gli strumenti per sviluppatori di Apple. Entrambe mostrano esattamente ciò che c’è nel file, simboli compresi. Premere Spazio nel Finder fa lo stesso, a meno che un’app non abbia aggiunto un’anteprima Markdown. Il file è a posto; il Mac semplicemente non sa come mostrarlo.

Come aprirlo come si deve

Una volta, senza installare nulla: aprilo in TextEdit e leggi scansando i simboli. Tollerabile per una nota breve, penoso per una tabella lunga.
Nel cloud: Documenti Google apre un file .md una volta caricato su Google Drive. Funziona, ma significa caricare il file da qualche parte, e per un documento privato è una decisione da ponderare.
In un editor di codice: VS Code mostra un’anteprima formattata premendo ⇧⌘V. Funziona, ma è uno strumento da programmatori e si vede.
In un’app Markdown: Hem è un’app gratuita e open source per Mac fatta apposta. Al primo avvio si offre come app per i file .md; dopo, il doppio clic mostra una pagina formattata, e Spazio nel Finder mostra anch’esso un’anteprima formattata. Il file resta sul tuo Mac. Hem esiste solo per Mac.

Un file .md aperto in Hem: i simboli sono spariti e il rapporto mostra un titolo, una tabella, un elenco e dei passaggi numerati.

Se il file te l’ha dato una chat di IA, prosegui con ChatGPT mi ha dato un file .md.

Come modificarlo

Qualsiasi editor di testo può cambiare un file .md, perché è solo testo. Il problema è che modifichi i simboli: per mettere una parola in grassetto digiti due asterischi per lato, e ti serve un’anteprima per controllare il risultato.

Se preferisci non imparare niente di tutto ciò, usa un’app che nasconda i simboli mentre lavori. In Hem fai clic nella pagina formattata e scrivi, più o meno come in Pages o Word. Selezionando del testo compare una piccola barra con grassetto, corsivo, titoli, elenchi, liste di controllo, link e citazioni; ⌘B e ⌘I funzionano come ti aspetti; Formato › «Inserisci tabella» aggiunge una tabella; le caselle si spuntano con un clic. Hem salva man mano nello stesso file .md e riscrive solo le parti che hai cambiato. Il file resta normale Markdown che un’IA o qualsiasi altra app può leggere.

Come convertirlo

In Word: in Hem, File › «Esporta come documento Word…» salva un .docx. Le altre strade, compresa quella di Documenti Google, sono in come trasformare un file .md in un documento Word.
In PDF: File › «Esporta come PDF…» in Hem.
In un’email o in un altro documento: copia da Hem con ⌘C e incolla in Mail, Word, Pages o Documenti Google. Titoli, grassetto, elenchi e tabelle arrivano come formattazione, non come simboli.
Di nuovo a un’IA: non serve convertirlo. Le chat di IA leggono il Markdown senza problemi, quindi incolla il testo o allega il file .md così com’è.

In breve

Un file .md è un documento di testo con la formattazione scritta sotto forma di simboli. Non è rotto, non è pericoloso e non è solo per programmatori. Gli serve soltanto un’app che legga i simboli, e su un Mac devi aggiungerla tu, perché non ce n’è una integrata.