IA sur votre appareil : performant et privé.

Documents

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

1

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.

2

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.

3

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.

4

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.

5

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 WordDans le fichier MarkdownBon à savoir
Styles Titre 1 à Titre 6Titres 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, italiqueAstérisques doubles et simples autour du texteLe texte dans un style de caractère code devient du code en ligne
Barré~~texte~~Écrit en HTML <s> en CommonMark
Liens hypertextesLiens MarkdownLe texte du lien et l'adresse sont tous deux conservés
TableauxTableaux à barres avec alignement des colonnesDes cellules fusionnées ou une liste dans une cellule font passer ce tableau en HTML
Notes de bas de page et notes de finRenvois [^1] avec les définitions à la finListe HTML numérotée en CommonMark
ImagesRéférences d'image comme images/image-1.pngLe texte de remplacement défini dans Word devient la description de l'image
Styles de paragraphe de citation et de codeBlocs de citation > et blocs de codeReconnus d'après les noms de style Word, comme Quote et Code
Souligné, surligné, exposant, indiceHTML <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.

VarianteTableauxBarré 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
CommonMarkTableaux HTMLHTML <s> et une liste de notes numérotéeLes analyseurs stricts qui refusent les extensions
PandocTableaux à 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 Markdown

Pour un résultat propre : préparer le document d'abord

  1. 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.
  2. 2Créez les listes avec les boutons puces et numérotation de Word, pas avec des tirets ou des numéros tapés.
  3. 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.
  4. 4Annulez les fusions de cellules quand c'est possible. Une grille simple donne un tableau à barres lisible ; une grille fusionnée donne du HTML.
  5. 5Remplissez Fichier > Informations > Propriétés (titre, auteur, objet, mots-clés) si vous voulez un front matter YAML utile.
  6. 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.

À lire ensuite

Plus sur Documents →