Télécharger un document enregistré au format Word

Le menu de téléchargement d’un document enregistré propose désormais un .docx, construit sur place à partir du même HTML que celui de l’aperçu. Aucun navigateur sans tête là-dedans — il faut enregistrer d’abord, puisque la conversion travaille sur la copie du compte.

Un document enregistré peut être téléchargé en .docx, construit à partir du même HTML que celui que l’aperçu affiche déjà. Word, Pages, LibreOffice et Google Docs l’ouvrent tous comme un document ordinaire — les titres sont des titres Word, les tableaux des tableaux Word, les listes s’imbriquent, et le code garde sa chasse fixe.

Ce qui survit au voyage

Les titres de un à six, les paragraphes, le gras et l’italique, les listes ordonnées et non ordonnées avec leur imbrication, les tableaux avec leur ligne d’en-tête, les citations, les filets horizontaux, les liens avec leur texte et leur adresse, et le code encadré. Ce qui ne survit pas : tout ce qui n’existe que dans un navigateur — une intégration vivante, une section repliable, un diagramme mermaid qui n’a jamais été rendu en image.

Les images distantes sont volontairement laissées de côté. Un convertisseur qui va chercher chaque image qu’un document mentionne est un convertisseur qui fait une requête vers toute adresse choisie par l’auteur du document, et le marché — une image contre un serveur qui suit les liens d’inconnus — ne vaut pas la peine.

Pourquoi il faut enregistrer d’abord

La conversion travaille sur la copie du document dans le compte, et c’est elle que lit le point d’accès de téléchargement. Convertir un fichier que vous venez tout juste de déposer est l’affaire du navigateur et ne concerne pas le compte ; .docx est la seule direction qui le concerne.

L’autre sens

Déposer un .docx sur le convertisseur le relit en Markdown — titres, tableaux, listes et le reste —, et c’est l’aller-retour que la plupart des gens veulent vraiment : un document Word sorti de la boîte aux lettres d’un collègue, vers Markdown, vers un dépôt.

Depuis un script

GET /api/v1/documents/:id.docx avec une clé d’API renvoie le même fichier, pour une chaîne de construction qui publie sa documentation en Word à l’intention de ceux qui la veulent ainsi.

Autres lectures : Markdown vers Word, en détail et relire un .docx en Markdown.