Convertir DOCX en Markdown
Pour faire passer une documentation de Word à un dépôt Git, il faut d'abord convertir chaque .docx en Markdown. Ce convertisseur produit un texte de style CommonMark, avec des titres #, des tableaux à barres verticales et des liens d'images, prêt à être commité.
Convertisseur de documents
ou déposez Fichiers PDF, DOC, DOCX … ici ·
95 Mo max. par fichier· Jusqu'à 20 fichiers· Supprimés après 30 minutes
Les fichiers sont traités sur nos serveurs et supprimés après 30 minutes.
150 DPI transforme une page A4 en environ 1240 × 1754 px. Utilisez 300 pour l’impression.
Convertit le fichier entier ou seulement certaines pages ou diapositives (fichiers PDF et présentations).
Pages ou diapositives à convertir, p. ex. 1-3, 5, 8-10.
UTF-8 convient à toutes les langues. Choisissez UTF-8 avec BOM si Excel ou le Bloc-notes sous Windows affiche des caractères illisibles ; les anciens encodages ne servent que pour les vieux logiciels.
LF pour macOS, Linux et les éditeurs de code ; CRLF pour les anciens programmes Windows comme le Bloc-notes classique.
La virgule est le standard. Utilisez le point-virgule pour Excel dans les pays où les décimales s’écrivent avec une virgule (Allemagne, France, Brésil).
Fichier Excel à plusieurs feuilles : les convertir toutes (une section ou un fichier par feuille) ou seulement la première.
Comment utiliser cet outil
- 1
Importez les fichiers Word
Ajoutez jusqu'à 20 fichiers .docx ou .doc, de 95 Mo maximum chacun. Acceptez ou rejetez d'abord les modifications suivies dans Word, car Markdown ne sait pas les afficher.
- 2
Vérifiez les options de texte
Mise en forme est réglée sur Simple, Encodage du texte sur UTF-8 et Fins de ligne sur LF, la combinaison attendue par Git et les générateurs de sites statiques. Laissez Inclure les images activé pour récupérer les images dans un dossier.
- 3
Convertissez et décompressez
Cliquez sur Convertir en MD. Chaque document arrive dans un ZIP contenant le fichier .md et ses images ; décompressez-le dans votre dossier de documentation et validez le commit.
Comment convertir un document Word en Markdown ?
Importez le fichier .docx et cliquez sur Convertir en MD. Vous obtenez un fichier .md avec des titres #, des listes, des liens et des tableaux, plus les images dans un dossier à côté, le tout dans un seul ZIP.
DOCX en Markdown pour le docs-as-code
Les équipes adoptent la documentation as code pour une raison : la documentation vit alors à côté du code, passe par les mêmes pull requests et sort avec la même version. Un fichier .docx casse ce principe, car c'est un ZIP de parties XML que Git stocke comme un binaire opaque. Un changement d'un seul mot apparaît comme un fichier modifié sans différence lisible, et deux personnes qui éditent en même temps ne peuvent pas fusionner leur travail.
Markdown est du texte brut : chaque modification est donc un changement de ligne visible. Il est aussi devenu bien plus prévisible en 2014, lorsque John MacFarlane et d'autres ont publié CommonMark, une spécification précise de la syntaxe que Gruber avait décrite de façon approximative dix ans plus tôt. GitHub a fondé sa propre spécification GitHub Flavored Markdown sur CommonMark en 2017, en ajoutant les tableaux à barres verticales, les listes de tâches et le texte barré que la plupart des README utilisent aujourd'hui.
Si votre contenu fait le chemin inverse, du Markdown vers un relecteur qui travaille dans Word, utilisez Markdown en DOCX. Pour une page web plutôt qu'un dépôt, DOCX en HTML conserve davantage la mise en forme.
À quoi ressemble le Markdown obtenu
## Liste de contrôle de version Avant de taguer une version, vérifiez les points suivants : - Les tests passent sur **main** - Le changelog liste chaque PR fusionnée | Étape | Responsable | | --- | --- | | Build | CI | | Publication | Mainteneur | 
Où s'affichera le Markdown converti
| Organisme | Exigence | Source |
|---|---|---|
| GitHub | Affiche README.md et tout fichier .md d'un dépôt avec GitHub Flavored Markdown | github.com |
| Hugo | Génère des pages à partir de fichiers de contenu .md avec un analyseur conforme à CommonMark | gohugo.io |
| Jekyll | Transforme les fichiers .md avec front matter en pages ; le moteur derrière GitHub Pages | jekyllrb.com |
| Docusaurus | Lit les fichiers .md et .mdx de son dossier docs comme pages de documentation | docusaurus.io |
DOCX
Document Microsoft Word
DOCX est le format de document par défaut de Microsoft Word depuis Office 2007, fondé sur la norme Office Open XML (ECMA-376, ISO/IEC 29500). C'est une archive ZIP de fichiers XML contenant texte, styles, images, tableaux, commentaires et modifications suivies. C'est le format le plus courant pour les documents modifiables en entreprise, à l'école et pour les candidatures. La mise en page peut varier légèrement entre Word, Google Docs, LibreOffice et Pages, surtout avec une mise en forme complexe. La plupart des traitements de texte ouvrent les fichiers DOCX.
- Compression
- –
- Transparence
- –
- Animation
- –
- Année de création
- 2007 · Microsoft
MD
Markdown
Markdown est une syntaxe de balisage légère créée par John Gruber en 2004. Elle utilise des symboles en texte brut, comme # pour les titres, * pour l'emphase et - pour les listes, qui restent lisibles en texte brut et se convertissent proprement en HTML. C'est la norme pour les fichiers README, la documentation, les wikis, les applications de notes et de nombreux générateurs de sites statiques. Il existe plusieurs variantes, comme CommonMark et GitHub Flavored Markdown, qui diffèrent sur des détails tels que les tableaux. N'importe quel éditeur de texte peut ouvrir les fichiers .md.
- Compression
- –
- Transparence
- –
- Animation
- –
- Année de création
- 2004 · John Gruber
On convertit un DOCX en Markdown quand un document passe dans un flux de travail de développement : un README, un site de documentation ou une base de connaissances gérée dans Git, où le texte brut peut être comparé, relu dans les pull requests et rendu par de nombreux outils.
Fonctions de Word sans équivalent en Markdown
À prévoir avant la conversion
- Les polices, les couleurs et la mise en page sont supprimées ; Markdown décrit la structure, et c'est le thème du site qui décide de l'apparence
- Les modifications suivies et les commentaires ne sont pas conservés : résolvez-les d'abord dans Word
- Les en-têtes, pieds de page et numéros de page n'ont pas leur place dans un fichier .md
- Les zones de texte et les images habillées deviennent des paragraphes ordinaires et des liens d'image
- Les titres mis en forme à la main, en gras 16 pt au lieu de Titre 2, ressortent en texte gras : appliquez d'abord de vrais styles de titre
- Le soulignement n'a pas de syntaxe Markdown : il est supprimé ou conservé en HTML
Questions sur la conversion DOCX en Markdown
Quelle variante de Markdown la conversion DOCX en MD suit-elle ?
Les titres, l'emphase, les listes, les liens et le code suivent CommonMark, et les tableaux utilisent la syntaxe à barres verticales de GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll et Docusaurus affichent tous correctement cette combinaison.
Que deviennent les cellules de tableau fusionnées ?
Les tableaux Markdown à barres verticales n'ont pas de cellules fusionnées : chaque zone fusionnée est donc redivisée en cellules individuelles, avec le texte dans la première. Reconstruisez les tableaux complexes en HTML dans le fichier .md, ou simplifiez-les dans Word avant la conversion.
Où vont les images de mon document Word ?
Avec Inclure les images activé, chaque image est enregistrée comme un fichier séparé dans le ZIP, et le Markdown y renvoie par un chemin relatif tel que images/figure-1.png. Gardez ce dossier à côté du fichier .md quand vous le déplacez.
Les notes de bas de page Word sont-elles conservées en Markdown ?
CommonMark n'a pas de syntaxe pour les notes de bas de page, mais GitHub a ajouté les notes [^1] en 2021 et la plupart des générateurs de sites les gèrent. Si votre moteur de rendu ne les gère pas, le texte des notes apparaît en simples paragraphes à la fin.
Puis-je convertir des Google Docs en Markdown de cette façon ?
Oui. Dans Google Docs, choisissez Fichier > Télécharger > Microsoft Word (.docx), puis importez ce fichier ici. Google Docs propose aussi son propre téléchargement au format Markdown, qui fonctionne bien pour les documents simples.
