Convertir DOCX en Markdown

1. 1

   Ajoutez votre document Word

   Déposez un fichier DOCX sur la zone de dépôt, ou cliquez sur Choisir un fichier. Seuls les fichiers Word .docx sont acceptés ; tout le reste est refusé immédiatement avec un message indiquant quoi faire. La conversion démarre toute seule : aucun bouton à presser avant.

2. 2

   Choisissez l'aspect du Markdown

   Choisissez une variante : GitHub Flavored Markdown pour les dépôts et la plupart des sites statiques, CommonMark pour les analyseurs stricts, ou Pandoc si la sortie alimente une chaîne Pandoc. Décidez ensuite du sort des images intégrées, de l'ajout d'un front matter YAML, de la rétrogradation des titres et de la coupure des longues lignes.

3. 3

   Vérifiez dans l'aperçu

   Basculez entre Source et Rendu. Source montre exactement le Markdown que vous allez emporter ; Rendu montre son aspect une fois lu par un moteur Markdown, pour confirmer que tableaux, listes et liens sont bien passés avant de valider le résultat.

4. 4

   Copiez ou téléchargez

   Utilisez Copier pour mettre le Markdown dans le presse-papiers, ou Télécharger pour enregistrer un fichier .md. Si le document contenait des images, téléchargez plutôt le ZIP : il contient le fichier .md et un dossier images dont les fichiers correspondent aux chemins du Markdown. Tout s'exécute sur votre appareil et aucun document n'est jamais téléversé.

Chaque partie d'un document Word ayant un équivalent Markdown est reportée, et celles qui n'en ont pas sont écrites en HTML plutôt que supprimées en silence.

• De vrais tableaux : Les tableaux Word deviennent des tableaux à barres verticales, avec un alignement des colonnes lu dans le document et non deviné.
• Notes de bas de page et de fin : Les deux deviennent des références [^1] dont les définitions sont rassemblées en fin de fichier.
• Mise en forme en ligne complète : Gras, italique, barré, souligné, surlignage, exposant, indice, code en ligne et liens sont conservés.
• Extraction d'images : Les images intégrées sont écrites dans un dossier images et livrées avec le Markdown en un seul ZIP.
• Front matter YAML : Titre, auteur, sujet, mots-clés et dates du document deviennent un bloc de front matter.
• Trois variantes de Markdown : GitHub Flavored Markdown, CommonMark et Pandoc, chacune avec la syntaxe qu'elle prend réellement en charge.
• Aperçu rendu : Basculez entre la source Markdown et son aspect final avant de copier ou télécharger quoi que ce soit.
• Lots en une archive : Convertissez de nombreux documents et emportez-les dans un seul ZIP au lieu d'une boîte de dialogue par fichier.

La structure est la partie d'un document Word la plus facile à perdre et la plus difficile à voir disparaître. Un convertisseur qui aplatit un tableau en paragraphes isolés produit une sortie qui semble correcte au premier coup d'œil et qui est fausse d'une manière que l'on ne découvre qu'après l'avoir collée quelque part. Cet outil traite la structure comme l'objet même de la conversion.

Comment un tableau Word devient du Markdown

• Lignes d'en-tête : Une ligne marquée par Word comme en-tête répété devient l'en-tête du tableau. Si aucune ne l'est, la première ligne est utilisée, car c'est presque toujours ce qu'elle est.
• Alignement des colonnes : Gauche, centre et droite sont lus dans l'alignement de paragraphe du document et écrits ---, :---: et ---:.
• Barres verticales dans les cellules : Une cellule contenant une barre verticale est échappée pour ne pas scinder la colonne en deux.
• Cellules à plusieurs paragraphes : Deux paragraphes dans une cellule sont joints par un retour à la ligne, ce qui préserve le tableau au lieu de forcer l'ensemble en HTML.
• Cellules fusionnées : Markdown ne sait pas exprimer une fusion : ces tableaux sont donc écrits en HTML, accepté par tous les moteurs et sans perte.
• Listes imbriquées : L'imbrication est préservée à toute profondeur, indentée comme CommonMark l'exige pour que le contenu s'aligne.

Le mot Markdown recouvre plusieurs dialectes réellement différents, et choisir le mauvais produit un fichier plein de ponctuation parasite au lieu d'une mise en forme. Le réglage de variante change la syntaxe émise, pas seulement une étiquette.

Laquelle choisir ?

• GitHub Flavored Markdown : L'option par défaut et la bonne réponse pour GitHub, GitLab, les wikis et la plupart des générateurs de sites statiques. Tableaux, ~~barré~~ et notes [^1] y sont disponibles.
• CommonMark : La base stricte. Aucune syntaxe pour les tableaux, le barré ou les notes : ces éléments sont écrits en HTML, qui s'affiche correctement partout au lieu de laisser des tildes et des barres littérales.
• Pandoc : Ajoute la syntaxe propre à Pandoc pour ^exposant^ et ~indice~. À choisir quand le Markdown alimente une chaîne Pandoc capable de les lire.

Un document Word contient généralement plus que du texte. Où vont ces éléments dépend de ce que vous comptez faire du Markdown : c'est donc un réglage et non une supposition.

Trois traitements possibles des images intégrées

• Extraire dans un dossier : Chaque image est écrite dans images/image-1.png et référencée par ce chemin relatif. Le téléchargement devient un ZIP contenant le fichier .md et le dossier, prêt à être versionné.
• Intégrer en ligne : Chaque image devient une URI de données dans le Markdown lui-même. Le fichier est autonome et bien plus lourd, ce qui convient pour coller un court extrait là où aucun fichier ne peut être hébergé.
• Les laisser de côté : Aucune référence d'image, pour une migration où les images sont déjà hébergées ailleurs et où seul le texte doit bouger.

Ce que contient le front matter

• Titre, auteur et sujet, tirés des propriétés que Word enregistre et non devinés depuis le texte.
• Mots-clés, répartis en liste YAML lorsque le document en compte plusieurs.
• Dates de création et de modification, au format ISO attendu par les générateurs de sites statiques.
• Chaque valeur est mise entre guillemets là où c'est nécessaire, pour qu'un titre contenant deux-points ne casse pas la génération du site qui le lit.

Convertir Word en Markdown permet le contrôle de version, produit du contenu adapté aux développeurs, facilite la documentation, autorise la publication sur GitHub et prépare les documents à la rédaction technique.

Avantages du format Markdown

• Contrôle de version : Le Markdown est du texte brut : un diff montre ce qui a réellement changé au lieu d'un bloc binaire.
• Adapté aux développeurs : Il vit à côté du code qu'il documente et ne demande aucun éditeur particulier.
• Publication GitHub : Les contenus README et wiki s'affichent nativement sur GitHub et GitLab.
• Rédaction technique : Les chaînes docs-as-code prennent le Markdown comme format d'entrée.
• Mise en forme simple : La syntaxe est assez légère pour se lire en texte brut et s'écrire sans barre d'outils.

La conversion se fait en deux étapes, et savoir laquelle est laquelle explique pourquoi changer un réglage est instantané alors que la première conversion prend un instant.

Déroulement de la conversion

• Lire le document : Le .docx est ouvert sur votre appareil et sa structure, ses styles, ses images et ses propriétés sont extraits. C'est la partie coûteuse, et elle a lieu une fois par fichier.
• Écrire le Markdown : La structure devient du Markdown selon la variante et les autres réglages. Du pur travail de texte, donc quasi instantané.
• Changer un réglage : Seule la deuxième étape est rejouée. C'est pourquoi l'aperçu se met à jour dès que vous touchez un contrôle, même sur un très long document.
• Lots : Chaque document est lu et écrit indépendamment, et chaque résultat peut être copié, téléchargé seul ou rassemblé dans une archive.

Connaître ces éléments aide à prendre de meilleures décisions de conversion.

Chiffres clés

• Un document de 25 000 mots contenant 50 tableaux est lu en environ 22 millisecondes et re-rendu en moins d'une milliseconde lorsqu'un réglage change.
• Seul le .docx est accepté. L'ancien format binaire .doc est refusé avec une explication, car c'est un autre format que Word peut convertir pour vous.
• La version gratuite couvre un document à la fois, jusqu'à 50 Mo, avec toutes les fonctions ; Pro couvre des lots jusqu'à 50.
• L'échappement reste minimal : les caractères pouvant amorcer du Markdown sont échappés, les autres restent exactement tels quels.
• Titres, listes, liens, emphases, tableaux, notes de bas de page et images sont tous conservés.

Convertit un document de 25 000 mots contenant 50 tableaux en bien moins d'une seconde, sur votre appareil.

Suivez ces conseils pour obtenir les meilleurs résultats de conversion Word vers Markdown.

Points de qualité

• Utilisez les styles de titre intégrés de Word plutôt qu'un gras agrandi à la main : un convertisseur ne reconnaît qu'un titre marqué comme tel.
• Consultez l'onglet Rendu avant de télécharger, surtout pour les documents à tableaux, afin de confirmer que la structure est bien passée.
• Si le Markdown s'insère sous un titre existant, rétrogradez les titres d'un niveau pour n'avoir qu'un seul titre de premier niveau.
• Ne choisissez CommonMark que si un analyseur strict l'exige ; ses replis en HTML sont corrects mais plus verbeux.
• Testez le fichier .md à sa destination (GitHub, site statique, wiki) après téléchargement.

Cas d'usage courants

• Documentation : Faire passer un manuel Word existant dans un dépôt docs-as-code sans le retaper.
• Publication GitHub : Transformer une spécification ou une proposition en README ou en page de wiki.
• Rédaction technique : Amener des brouillons écrits sous Word dans une chaîne Markdown pour relecture et versionnage.
• Articles de blog : Convertir un brouillon en article pour un générateur de site statique, front matter compris.
• Contenu développeur : Extraire tableaux et contenus de type code d'une spécification Word vers une forme comparable.

• Word vers PDF
• Word vers HTML
• Visionneuse Word
• Word vers texte
• Compresser Word
• CSV vers Markdown