Quand Markdown est-il le bon format ?
Utilisez une copie Markdown pour du texte recherchable, une source vérifiable à résumer ou un ensemble léger de documents à comparer. C’est une représentation de travail, pas le remplacement du Word original.
Si l’acceptation dépend de pagination exacte, mise en page, signatures, commentaires ou suivi des modifications, conservez le DOCX et examinez-le dans Word ou en PDF rendu. Un Markdown propre ne prouve pas que toutes les fonctions Word ont été conservées.
convert-word-to-md est un Agent Skill GitHub Copilot, pas un service de téléversement navigateur. Lisez sa fiche et utilisez sa commande propre à la plateforme avant installation.
Étape 1 : vérifier fichier, accès et destination
Confirmez que chaque entrée est .docx. La méthode examinée ne traite pas l’ancien .doc ; enregistrez-le d’abord en DOCX. Dans un dossier mixte, prenez aussi explicitement en compte PDF et classeurs : le script Word ignore volontairement les autres formats.
Le script crée des copies Markdown et images. Confirmez que l’environnement de l’agent est autorisé pour ce document et appliquez au dossier généré les mêmes règles d’accès et de conservation qu’à l’original.
- Listez fichiers d’entrée et formats avant un lot.
- Décidez de l’emplacement de sortie ; par défaut, il est créé près de chaque source.
- Choisissez une nouvelle destination pour conserver une modification Markdown antérieure.
Étape 2 : installer le skill et sa dépendance Python
La préparation source exige Python 3.10 ou supérieur, pip et la dépendance DOCX de MarkItDown. Lancez-la depuis le dossier du skill et vérifiez l’import dans le même environnement Python que le convertisseur. Le fichier requirements définit un minimum, pas une version exacte verrouillée.
Ces commandes préparent la dépendance du convertisseur ; elles n’installent pas l’Agent Skill. Utilisez la commande à copier sur sa fiche pour GitHub Copilot.
python --versionpython -m pip install -r scripts/requirements.txtpython -c "from markitdown import MarkItDown; print('markitdown OK')"Étape 3 : convertir un DOCX ou un dossier
Exécutez le script inclus depuis le dossier du skill. Remplacez les chemins exemples par les vrais chemins d’entrée. Un fichier obtient un dossier de sortie de même nom ; le mode récursif trouve les DOCX dans les sous-dossiers et conserve leur structure relative sous une destination de lot choisie explicitement.
Un document contenant des images produit de vrais fichiers sous img/ et des liens relatifs dans le Markdown. Partagez ou déplacez le dossier complet, pas seulement le fichier .md.
python scripts/convert_word_to_md.py "/path/to/report.docx"python scripts/convert_word_to_md.py "/path/to/docx-folder" --recursivepython scripts/convert_word_to_md.py "/path/to/report.docx" -o "/path/to/fresh-output"- La première commande utilise la sortie par défaut près de la source.
- Utilisez -o uniquement pour une destination distincte volontaire ; examinez-la avant exécution.
- Pour les lots, examinez séparément chaque échec au lieu de considérer une réussite partielle comme une conversion complète.
Étape 4 : vérifier le Markdown avant analyse
Convertir prépare le contenu sans l’interpréter. Comparez la sortie à la source avant de demander à un agent de résumer, comparer ou extraire des informations importantes.
- Comparez ordre des titres, paragraphes, listes et libellés et valeurs clés des tableaux.
- Ouvrez chaque lien relatif d’image et vérifiez sa place attendue dans le document.
- Examinez dans l’original en-têtes, pieds de page, notes, commentaires, modifications suivies, sauts de page et mise en page complexe : ce petit contrôle ne les valide pas.
- Confirmez que la sortie ne contient que les fichiers à conserver ou partager.
Attention : une nouvelle exécution peut supprimer un dossier de sortie existant
L’examen du code montre que le script à cette révision supprime une destination existante avant d’écrire une nouvelle conversion. Cela peut supprimer un Markdown modifié manuellement ou d’autres fichiers. Ce comportement n’a pas été exercé dans notre exemple : sauvegardez le travail ou choisissez une nouvelle destination avant de recommencer.
C’est un constat de source, pas l’affirmation que SkillSignal a testé une opération destructrice. Lisez l’implémentation et confirmez la destination avant vos vrais fichiers.
Ce que prouve le contrôle exemple, et ses limites
Le 14 octobre 2026, SkillSignal a exécuté le script Python à la révision indiquée avec deux DOCX synthétiques et MarkItDown 0.1.8. Le contrôle vérifiait certains titres, textes de listes, deux valeurs de tableau, ordre et octets des images, un fichier textuel et l’absence de changement des empreintes sources.
Il ne testait ni chargement GitHub Copilot, ni installation, récursivité, tableaux complexes, pagination, commentaires, suivi des modifications, fichiers protégés, documents clients ou sécurité. Ce n’est ni un test comparatif ni une garantie générale d’exactitude. La dépendance accepte markitdown[docx]>=0.1.0 ; un nouvel environnement peut résoudre une autre version.