Incollare Markdown in Word o Google Docs senza perdere la formattazione

Ridurre il Markdown a caratteri è la risposta giusta per un campo di modulo. È la risposta sbagliata per un documento. Se stai incollando in Word o in Google Docs, vuoi che i titoli siano titoli e che la tabella sia una tabella.

È una conversione diversa, e passa da una parte degli appunti a cui quasi nessuno pensa.

Gli appunti contengono più di una cosa

Una singola operazione di copia può portare lo stesso contenuto in più formati insieme. Quando copi da un word processor, gli appunti ricevono text/html e text/plain. L’applicazione in cui incolli prende quello che capisce: Word prende l’HTML e ricostruisce la formattazione; un terminale prende il testo semplice e ignora il resto.

È per questo che incollare da un browser dentro Word conserva il grassetto, mentre incollare la stessa cosa in un editor di codice no. Non si è perso niente: due versioni hanno viaggiato insieme e ogni destinazione ne ha scelta una.

La conversione in testo formattato qui le scrive entrambe. Scegli Testo formattato come formato di uscita e premi Copia: gli appunti ricevono l’HTML reso insieme a un ripiego in testo semplice. Incolla in Word, Docs, Gmail o Outlook e la formattazione arriva. Incolla in un terminale e ottieni testo leggibile invece che markup.

Cosa passa

Titoli, grassetto e corsivo, elenchi ordinati e non ordinati con il loro annidamento, tabelle con celle vere, link come link veri, codice in linea e blocchi di codice, citazioni, e immagini dove la destinazione riesce a raggiungerle.

Gli elenchi di attività passano come caselle di spunta. Le note a piè di pagina passano come link alle loro definizioni.

Dove si complica

Firefox tiene dietro una preferenza l’API degli appunti che scrive più formati, quindi lì la strada automatica non è disponibile. Il ripiego seleziona l’anteprima resa, così che un Ctrl/⌘+C manuale porti ancora con sé la formattazione: la copia del browser gestisce le due versioni anche quando l’API non lo fa.

Le immagini sono riferimenti, non dati. Se il Markdown punta a https://example.com/grafico.png, il documento incollato punta allo stesso URL. Si vede dove quell’indirizzo è raggiungibile e si rompe dove non lo è. Se l’immagine deve viaggiare con il documento, scarica l’HTML e tieni l’immagine accanto, oppure inserisci tu la figura nella destinazione.

Google Docs è più severo di Word su quale HTML accetta e ogni tanto semplifica una struttura annidata. Gli elenchi molto annidati sono la vittima abituale.

Le impostazioni valgono ancora

Un’ipotesi diffusa è che il testo formattato ignori le impostazioni di conversione, dato che l’HTML ha un elemento vero per tutto. In gran parte è così, ma non del tutto. Diverse impostazioni cambiano il documento stesso e non come viene disegnato:

• I link possono tenere solo il testo, mostrare l’URL, o diventare l’URL.
• Le immagini si possono tenere o togliere.
• I blocchi di codice, le citazioni e le note a piè di pagina si possono togliere.
• I titoli si possono mettere in maiuscolo.
• La punteggiatura si può normalizzare in ASCII.

Queste valgono per il testo formattato e per l’HTML tanto quanto per il testo semplice. Quelle che davvero non valgono sono quelle che danno forma ai caratteri — il simbolo dell’elenco puntato, la disposizione delle tabelle, i segni delle liste di attività, la fusione delle righe vuote — perché a un elenco HTML non serve che gli si scelga un carattere di punto. Quelle si disattivano quando esci dalla modalità testo semplice, e il pannello spiega perché.

Se ti serve un file invece di un incolla

Lo stesso risultato si scarica come .html autonomo con lo stile incorporato, quindi si apre correttamente senza rete, oppure si stampa in PDF.