Scaricare un documento salvato come Word

Il menu di download di un documento salvato offre ora un .docx, costruito sul posto a partire dallo stesso HTML che l’anteprima già mostra. Nessun browser headless di mezzo — serve prima un salvataggio, perché la conversione lavora sulla copia nell’account.

Un documento salvato può essere scaricato come .docx, costruito a partire dallo stesso HTML che l’anteprima già mostra. Word, Pages, LibreOffice e Google Docs lo aprono come un documento qualsiasi — i titoli sono titoli di Word, le tabelle sono tabelle di Word, gli elenchi si annidano e il codice mantiene il suo monospaziato.

Che cosa sopravvive al viaggio

I titoli da uno a sei, i paragrafi, il grassetto e il corsivo, gli elenchi numerati e puntati con la loro annidatura, le tabelle con la riga di intestazione, le citazioni, le linee orizzontali, i link con il loro testo e il loro indirizzo, e il codice recintato. Che cosa no: tutto ciò che esiste solo dentro un browser — un incorporamento vivo, una sezione richiudibile, un diagramma mermaid mai reso come immagine.

Le immagini remote restano fuori di proposito. Un convertitore che va a prendere ogni figura citata da un documento è un convertitore che fa una richiesta a qualunque indirizzo abbia scelto l’autore di quel documento, e lo scambio — una figura in cambio di un server che segue i link di sconosciuti — non conviene.

Perché serve prima un salvataggio

La conversione lavora sulla copia del documento nell’account, ed è quella che l’endpoint di download legge. Convertire un file appena rilasciato è compito del browser e non coinvolge affatto l’account; .docx è l’unica direzione che lo fa.

La direzione opposta

Rilasciare un .docx sul convertitore lo rilegge in Markdown — titoli, tabelle, elenchi e tutto il resto — ed è il giro di andata e ritorno che la maggior parte delle persone vuole davvero: un documento Word uscito dalla casella di posta di un collega, in Markdown, dentro un repository.

Da uno script

GET /api/v1/documents/:id.docx con una chiave API restituisce lo stesso file, per una build che pubblica la documentazione in Word per chi la vuole così.

Da leggere: da Markdown a Word, per esteso e rileggere un .docx in Markdown.