Perché Markdown e non testo semplice
Quando converti un’immagine in testo semplice, la struttura si perde. Un titolo sembra una riga qualsiasi, un elenco diventa una serie di frasi slegate e una tabella si trasforma in un miscuglio di parole nell’ordine sbagliato. Markdown conserva quella struttura con caratteri normali, così sopravvive quasi ovunque la incolli.
Lo stesso risultato funziona nelle app per appunti che salvano in Markdown, nei siti di documentazione, nei wiki, nei file README e nelle chat con gli assistenti IA. Resta leggibile come testo grezzo, si modifica facilmente a mano e le modifiche si vedono chiaramente nel controllo di versione.
Come viene scritta ogni parte della pagina
Ogni tipo di contenuto ha la sua forma in Markdown:
| Nell’immagine | Nel Markdown |
|---|---|
| Un titolo | Una riga che inizia con uno o più # |
| Un elenco puntato | Righe che iniziano con - |
| Un elenco numerato | Righe che iniziano con 1., 2. e così via |
| Una tabella, letta in modalità Tabella | Una tabella Markdown con barre verticali tra le colonne |
| Codice, letto in modalità Codice | Un blocco di codice delimitato |
Lo screenshot di una breve checklist in modalità Documento potrebbe uscire così:
# Checklist di rilascio
Esegui questi passaggi prima di creare il tag di una nuova versione.
- Congela il branch main
- Aggiorna il changelog
1. Compila il pacchetto
2. Esegui tutta la suite di test
Le righe che vanno a capo all’interno di un paragrafo vengono unite e le parole divise da un trattino a fine riga vengono ricomposte, così il paragrafo diventa una sola riga di Markdown invece di tanti pezzi spezzati.
Pagine che mescolano testo, tabelle e codice
Ogni immagine viene letta in una sola modalità alla volta, scelta separatamente per ciascuna. Conta per gli screenshot che affiancano un paragrafo e una tabella, o per la pagina di un tutorial con un esempio di codice nel mezzo. La modalità Documento è pensata per la prosa, quindi una tabella letta così di solito esce come righe di testo invece che come griglia.
La soluzione è dividere la pagina. Fai uno screenshot del testo e un altro della tabella o del codice, imposta per ciascuno la modalità giusta e trascinali nell’ordine corretto. La vista Documento intero combina poi tutte le pagine in un unico file Markdown, oppure in uno ZIP con un file per pagina.
Per le immagini piene di tabelle, come estrarre tabelle dalle immagini spiega come ottenere righe e colonne corrette. Per gli esempi di codice, screenshot di codice in testo spiega cosa ricontrollare, come le parentesi e i caratteri che si somigliano.
Usare il Markdown in un prompt per l’IA
Incollare il testo in una chat con un assistente IA, invece dell’immagine, ti permette di controllare cosa vede. Puoi leggere prima il testo, correggere le parole lette male, eliminare ciò che è privato o irrilevante e mantenere titoli, elenchi e tabelle ben segnati.
Una tabella incollata in Markdown conserva righe e colonne come testo, così puoi citarle direttamente nella domanda, per esempio «confronta la colonna di marzo con quella di aprile». Un elenco numerato mantiene i suoi numeri, quindi «riscrivi il passaggio 3» significa la stessa cosa per te e per l’assistente.
Sistemare il risultato prima di incollarlo
Qualche controllo veloce rende il Markdown più pulito:
- Livelli dei titoli. Assicurati che il titolo della pagina e quelli delle sezioni abbiano il livello che vuoi. Aggiungere o togliere un
#è un attimo. - Elenchi numerati su più screenshot. Un elenco che continua da uno screenshot al successivo può ripartire da 1, quindi controlla i numeri dopo aver unito le pagine.
- A capo da mantenere. Per una poesia, un indirizzo o il testo di una canzone, disattiva «Unisci righe», così ogni riga resta com’era.
- Errori ripetuti. Se una parola viene letta male sempre allo stesso modo, Trova e sostituisci la corregge in un colpo solo.
Se preferisci finire il lavoro in un programma di videoscrittura, immagine in Word ti dà un .docx con gli stessi titoli ed elenchi.