Comment convertir Word en Markdown (DOCX en .md avec tableaux, liens et images)
Convertissez Word en Markdown en ligne : titres, listes, tableaux, liens et images passent proprement. Ce qui ne peut pas être converti (mise en page, commentaires, couleurs).
Mis à jour le 8 novembre 202610 min de lecture
Pour convertir Word en Markdown, ouvrez un convertisseur DOCX vers Markdown, ajoutez votre fichier .docx, puis copiez ou téléchargez le résultat .md. Ce qui passe, c'est la structure du document : les titres deviennent des lignes commençant par #, les listes à puces et numérotées des éléments - et 1., le gras et l'italique deviennent ** et *, les liens restent cliquables, les tableaux deviennent des tableaux à barres verticales et les images des références d'image. Ce qui ne passe pas, c'est l'apparence de la page. Le Markdown est du texte brut avec un peu de ponctuation : les polices, les couleurs, les marges, les colonnes et les commentaires Word n'y ont pas leur place. Savoir de quel côté de cette limite se trouve chaque partie de votre document fait la différence entre un fichier propre et un après-midi de corrections à la main.
Comment convertir Word en Markdown, étape par étape
Ajouter le fichier .docx
Ouvrez le convertisseur Word vers Markdown et déposez-y le document, ou cliquez sur « Choisir un fichier ». Seul le .docx est accepté. Un ancien fichier .doc est refusé avec un message, car c'est un autre format : ouvrez-le dans Word ou Google Docs et enregistrez-le d'abord en .docx. La conversion démarre toute seule.
Choisir la variante de Markdown
Laissez GitHub pour GitHub, GitLab, la plupart des wikis et la plupart des générateurs de sites statiques. Choisissez CommonMark uniquement pour un analyseur strict, ou Pandoc si le fichier part dans une chaîne de traitement Pandoc. Le tableau plus bas montre ce qui change.
Décider du sort des images
Sous « Images intégrées », choisissez Extraire (les images vont dans un dossier images et le téléchargement devient un ZIP), En ligne (les images sont écrites dans le fichier .md lui-même) ou Ignorer.
Régler les options facultatives
« Rétrograder les titres » descend chaque titre d'un à trois niveaux, pour qu'un document dont le titre est en Titre 1 puisse se placer sous un titre de page existant. « Largeur de ligne » coupe les paragraphes à 80 ou 100 colonnes, ou pas du tout. « Ajouter un front matter YAML » écrit en tête du fichier le titre, l'auteur, l'objet, les mots-clés et les dates tirés des propriétés du document.
Vérifier l'aperçu, puis copier ou télécharger
Basculez entre « Source » (le texte exact que vous allez récupérer) et « Rendu » (l'affichage qu'en donnera un moteur de rendu Markdown). Cliquez ensuite sur « Copier », sur « Télécharger le .md », ou téléchargez le ZIP si vous avez extrait des images. Chaque réglage met l'aperçu à jour immédiatement : essayez-en plusieurs avant de vous décider.
Ce qui se convertit proprement
Tout ce qui décrit la structure du texte possède un équivalent Markdown ou une solution de repli HTML sûre, et le convertisseur l'écrit au lieu de l'aplatir en simples paragraphes.
| Dans Word | Dans le fichier Markdown | Bon à savoir |
|---|---|---|
| Styles Titre 1 à Titre 6 | Titres de # à ###### | Seul le texte doté d'un vrai style de titre compte ; un gros texte en gras reste un paragraphe |
| Listes à puces et numérotées | Éléments - et 1. | L'imbrication est conservée à n'importe quelle profondeur |
| Gras, italique | Astérisques doubles et simples autour du texte | Le texte dans un style de caractère code devient du code en ligne |
| Barré | ~~texte~~ | Écrit en HTML <s> en CommonMark |
| Liens hypertextes | Liens Markdown | Le texte du lien et l'adresse sont tous deux conservés |
| Tableaux | Tableaux à barres avec alignement des colonnes | Des cellules fusionnées ou une liste dans une cellule font passer ce tableau en HTML |
| Notes de bas de page et notes de fin | Renvois [^1] avec les définitions à la fin | Liste HTML numérotée en CommonMark |
| Images | Références d'image comme images/image-1.png | Le texte de remplacement défini dans Word devient la description de l'image |
| Styles de paragraphe de citation et de code | Blocs de citation > et blocs de code | Reconnus d'après les noms de style Word, comme Quote et Code |
| Souligné, surligné, exposant, indice | HTML <u>, <mark>, <sup>, <sub> | Pandoc écrit ^sup^ et ~sub~ à la place |
Les tableaux méritent une remarque à part. L'alignement des colonnes (gauche, centré, droite) est lu dans le document et écrit sous la forme ---, :---: et ---:. Si Word a marqué une ligne comme ligne d'en-tête répétée, elle devient l'en-tête ; si aucune ligne n'est marquée, la première est utilisée, car un tableau à barres en exige une. Une barre verticale dans une cellule est échappée pour ne pas couper la colonne en deux, et deux paragraphes dans une même cellule sont réunis par un saut de ligne. Quand un tableau utilise des cellules fusionnées, le Markdown n'a tout simplement aucune syntaxe pour cela : ce tableau précis est donc écrit en HTML, que tous les moteurs de rendu Markdown courants affichent correctement. La carte de résultat vous indique combien de tableaux ont pris ce chemin.
Ce qui ne peut pas être converti, et pourquoi
Le Markdown a été conçu pour décrire ce qu'est un texte, pas son apparence. Les éléments ci-dessous ne disparaissent pas à cause d'un convertisseur médiocre : il n'existe simplement pas de Markdown pour les écrire.
- La mise en page. Marges, format de page, sauts de page, sauts de section, colonnes de texte multiples et position des images ou zones de texte flottantes. Un fichier Markdown n'a pas de pages ; c'est un flux de texte unique que la destination met en forme.
- Les commentaires. Les commentaires de révision dans la marge ne sont pas écrits dans le fichier .md. S'ils comptent, résolvez-les ou copiez-les ailleurs avant la conversion.
- Les couleurs, polices et tailles. La couleur de police, la famille de police, la taille en points et l'interligne disparaissent. Le surlignage n'est conservé que sous forme de balise <mark>, que la plupart des moteurs de rendu affichent dans leur propre couleur par défaut, pas dans la vôtre.
- Les en-têtes et pieds de page. En-têtes, pieds de page et numéros de page relèvent de la mise en page et ne font pas partie du texte converti.
- L'alignement des paragraphes ordinaires. Un texte centré ou aligné à droite devient un paragraphe ordinaire aligné à gauche. Seules les colonnes de tableau gardent leur alignement.
- La mise en forme manuelle qui imite une structure. Une ligne en gras à 16 pt ressemble à un titre dans Word, mais pour n'importe quel convertisseur ce n'est qu'un paragraphe. Les lignes commençant par un tiret ou un numéro tapé à la main, au lieu d'une vraie liste, deviennent des paragraphes qui commencent par ce caractère.
Quelle variante de Markdown choisir
Le Markdown est une famille de dialectes. Ils s'accordent sur les titres, les listes, l'emphase et les liens, et divergent sur le reste ; un mauvais choix se voit sous forme de tildes et de barres égarés sur la page.
| Variante | Tableaux | Barré et notes de bas de page | À utiliser pour |
|---|---|---|---|
| GitHub (par défaut) | Tableaux à barres | ~~texte~~ et [^1] | GitHub, GitLab, les wikis, la plupart des générateurs de sites statiques et des applis de notes |
| CommonMark | Tableaux HTML | HTML <s> et une liste de notes numérotée | Les analyseurs stricts qui refusent les extensions |
| Pandoc | Tableaux à barres | ~~texte~~ et [^1], plus ^sup^ et ~sub~ | Les fichiers que Pandoc convertira de nouveau |
Dans le doute, gardez GitHub. La sortie CommonMark est correcte partout, mais plus verbeuse, car chaque tableau et chaque note de bas de page se rabattent sur le HTML.
Images : extraire, en ligne ou ignorer
Extraire est le bon choix pour un dépôt, un site de documentation ou un générateur de sites statiques. Chaque image est enregistrée sous images/image-1.png, images/image-2.png, etc., le Markdown pointe vers ces chemins relatifs, et le téléchargement est un ZIP contenant le fichier .md et le dossier. Décompressez-le d'un bloc pour que les chemins restent valides. En ligne transforme chaque image en URI de données dans le texte. Le fichier n'a besoin de rien à côté, mais une seule photo peut ajouter des mégaoctets de caractères illisibles : réservez-le aux courts extraits collés là où l'on ne peut pas héberger de fichiers. Ignorer n'écrit aucune référence d'image, ce qui convient à une migration où les images sont déjà hébergées ailleurs.
Avec l'offre gratuite, les images extraites sont écrites avec jusqu'à 4096 pixels sur le côté le plus long, soit plus que ce qu'affiche une page de documentation ordinaire. Pro les garde dans leur résolution d'origine.
Tableaux, notes de bas de page, liens, images et front matter YAML, en variante GitHub, CommonMark ou Pandoc. Gratuit : un .docx à la fois jusqu'à 50 Mo, tous les réglages de conversion inclus, images jusqu'à 4096 px. Pro : lots de 50 documents maximum dans un ZIP et images en pleine résolution. Tout s'exécute sur votre appareil, pas sur nos serveurs.
Convertir Word en MarkdownPour un résultat propre : préparer le document d'abord
- 1Appliquez de vrais styles de titre à chaque titre, et vérifiez qu'il n'y a qu'un seul Titre 1 si le fichier doit devenir une page unique.
- 2Créez les listes avec les boutons puces et numérotation de Word, pas avec des tirets ou des numéros tapés.
- 3Ajoutez un texte de remplacement aux images (clic droit sur l'image, puis l'option de texte de remplacement). Il devient la description de l'image dans le Markdown, celle que lisent les lecteurs d'écran et les moteurs de recherche.
- 4Annulez les fusions de cellules quand c'est possible. Une grille simple donne un tableau à barres lisible ; une grille fusionnée donne du HTML.
- 5Remplissez Fichier > Informations > Propriétés (titre, auteur, objet, mots-clés) si vous voulez un front matter YAML utile.
- 6Si le fichier dépasse 50 Mo, ce sont presque toujours les images. Compressez le document Word d'abord, et consultez compresser un document Word pour savoir ce que cela change.
Quand le Markdown n'est pas la bonne cible
Le Markdown est idéal quand le texte sera modifié, versionné ou publié par un site qui applique sa propre mise en forme. Si l'objectif est que le document garde exactement l'aspect qu'il a dans Word, ce n'est pas le bon format. Pour une copie imprimable qui conserve chaque page telle qu'elle a été conçue, utilisez Word en PDF ; ce qui survit à une conversion Word en PDF traite des polices et de la mise en page. Si la destination attend du HTML plutôt que du Markdown, Word en HTML l'écrit directement. Si vous n'avez besoin que des mots, Word en texte vous donne du texte brut sans balisage à nettoyer.
Si votre tableau vient d'un tableur et non d'un document Word, laissez Word de côté : convertir un CSV en Markdown explique comment transformer directement les données en tableau à barres avec l'outil CSV en Markdown.
Questions fréquentes
Comment convertir un document Word en Markdown ?
Ajoutez le .docx au convertisseur Word vers Markdown, choisissez une variante (GitHub par défaut), décidez du sort des images, vérifiez l'aperçu « Rendu », puis cliquez sur « Copier » ou « Télécharger le .md ». L'offre gratuite convertit un document à la fois, jusqu'à 50 Mo.
Peut-on convertir un DOCX en Markdown avec les tableaux ?
Oui. Les tableaux Word deviennent des tableaux à barres dont l'alignement des colonnes est lu dans le document. Un tableau avec des cellules fusionnées, ou avec une liste dans une cellule, n'a pas d'équivalent à barres : il est donc écrit en tableau HTML, que les moteurs de rendu Markdown affichent normalement.
Pourquoi mes titres deviennent-ils du texte normal après la conversion ?
Le document utilise du texte en gras ou plus grand au lieu des styles de titre de Word. Un convertisseur ne reconnaît un titre que s'il est marqué comme tel. Appliquez Titre 1, 2 ou 3 dans Word et relancez la conversion.
Les commentaires et les couleurs de police Word sont-ils conservés dans le Markdown ?
Non. Le Markdown n'a aucune syntaxe pour les commentaires de révision, les couleurs de police, les polices, les tailles ou la mise en page : ils ne sont donc pas écrits dans le fichier .md. Le surlignage est conservé en balise <mark> et le soulignement en <u>.
Peut-on convertir un fichier .doc en Markdown ?
Pas directement. Seul le .docx est accepté. Ouvrez le fichier .doc dans Word ou Google Docs, enregistrez-le ou téléchargez-le en .docx, puis convertissez ce dernier.
Peut-on convertir plusieurs fichiers Word en Markdown à la fois ?
La conversion par lots est une fonction Pro : jusqu'à 50 documents d'un coup, réunis dans un seul ZIP avec chaque fichier .md et ses images. Avec l'offre gratuite, vous convertissez un document à la fois, avec tous les réglages disponibles.