De docx à Obsidian : bien gérer les chemins d'images
Le texte se convertit proprement entre Word et Markdown. Ce sont les images qui font échouer les migrations : dès qu'un fichier converti entre dans un vault, chaque capture d'écran doit être un vrai fichier sur le disque, à un chemin qu'Obsidian peut résoudre depuis l'emplacement de cette note. Réglez d'abord la chaîne de traitement des images, et tout le reste devient une routine.
Ce guide explique comment Pandoc extrait les médias d'un fichier docx, ce qui atterrit sur le disque, et propose un flux de travail reproductible qui se termine par une note Obsidian fonctionnelle, ainsi que les deux pièges classiques : les noms d'images qui entrent en collision entre documents et les formats vectoriels Windows qu'Obsidian ne peut pas afficher.
Pourquoi les images sont la partie difficile
Un fichier docx est une archive ZIP. Les paragraphes vivent dans le XML, mais chaque capture, graphique et diagramme se trouve dans un dossier médias à l'intérieur de cette archive, référencé par des relations internes plutôt que par des chemins du système de fichiers. Rien de ce que vous voyez dans Word ne correspond à ce dont un fichier Markdown a besoin ensuite : un convertisseur doit donc réécrire le texte et décompresser les binaires en même temps.
Sautez la moitié du dépaquetage et vous obtenez une note pleine de liens qui ne mènent nulle part. Obsidian affiche les espaces réservés cassés sans se plaindre, et les dégâts apparaissent généralement des semaines plus tard, quand vous ouvrez la note sur un autre appareil ou partagez le vault avec un collègue. Planifier la chaîne de traitement des images avant de convertir est ce qui sépare une migration propre d'une opération de réparation.
Comment Pandoc extrait les médias
Pandoc, le moteur derrière le convertisseur de ce site, gère l'extraction dans son lecteur docx. Avec l'extraction des médias activée, chaque image incorporée est écrite sur le disque sous le nom qu'elle portait dans le paquet : image1.png, image2.jpeg, et ainsi de suite, rassemblées dans un dossier media situé à côté du document converti.
La sortie Markdown référence exactement ces chemins, de sorte que la note et son dossier médias voyagent ensemble. Téléchargez le résultat en ZIP et vous recevez les deux en même temps : le fichier .md plus chaque image qu'il mentionne. Décompressez l'archive n'importe où et les liens sont déjà corrects, car les références sont relatives à la note.
Deux détails méritent d'être connus. Les noms viennent du paquet docx, pas de vos légendes, donc une photo étiquetée Survey Site B peut atterrir sous le nom image7.png. Et la numérotation repart à zéro pour chaque document : chaque fichier Word recommence à image1, ce qui devient un problème de collision dès que plusieurs documents convertis partagent un même dossier.
Base64 en ligne ou dossier séparé
Le mode Base64 adopte l'approche inverse : les images sont incorporées directement dans le Markdown sous forme de data URIs au lieu d'être écrites sur le disque. Le résultat est un fichier unique et autonome, sans dossier médias à perdre, ce qui est pratique quand une note doit voyager comme une seule pièce jointe ou survivre à un collage entre outils.
Pour un vault, les vrais fichiers l'emportent généralement. Les data URIs gonflent la taille d'environ un tiers, et quelques captures peuvent transformer une note en plusieurs mégaoctets de texte base64 qui ralentissent l'éditeur et rendent les diffs et le contrôle de version inutilisables. Les vrais fichiers peuvent aussi être compressés ou renommés une seule fois, ce qui corrige toutes les notes qui les référencent ; des données d'image figées dans une note ne peuvent jamais être mises à jour en un seul endroit.
Les conventions de pièces jointes d'Obsidian
Obsidian vous laisse choisir une organisation, et deux réglages comptent ici. Sous Files and links (Fichiers et liens), Default location for new attachments (Emplacement par défaut des nouvelles pièces jointes) décide où vont les images déposées : la racine du vault, le dossier courant ou un dossier que vous nommez. La plupart des vaults convergent vers un dossier de pièces jointes unique pour l'ensemble du vault.
Le Markdown converti arrive avec des références relatives comme media/image1.png, qu'Obsidian résout par rapport à l'emplacement de la note elle-même, donc le placement est simple au départ : gardez le dossier media à côté de la note. New link format (Format des nouveaux liens) contrôle ce qu'Obsidian écrira désormais, et les chemins relatifs sont le choix le plus sûr, car les notes continuent de fonctionner quand le vault change de machine ou d'outil de synchronisation.
Un flux de travail qui réussit du premier coup
D'abord, déposez le docx dans le convertisseur de ce site et gardez le mode image sur ZIP. La conversion s'exécute entièrement dans votre navigateur, donc les brouillons non publiés ne quittent jamais la machine, et le téléchargement contient le fichier .md plus son dossier médias, déjà reliés par des chemins relatifs.
Ensuite, décompressez le ZIP dans le dossier du vault où la note doit vivre, en gardant le .md et le dossier media côte à côte. Ouvrez le vault et les images s'affichent du premier coup, car chaque référence pointe vers un fichier qui existe réellement à un niveau de distance.
Enfin, rangez depuis Obsidian, pas depuis le gestionnaire de fichiers. Sélectionnez une image, faites-la glisser dans votre dossier de pièces jointes, et Obsidian déplace le fichier et réécrit la référence dans la même action. Déplacer des fichiers en dehors de l'application laisse des liens obsolètes derrière soi, car rien ne rescanne les chemins modifiés dans son dos.
Quand les documents entrent en collision
Chaque document Word numérote ses images à partir de un, donc dix articles convertis contiennent dix fichiers image1.png différents. Copiez-les tous dans un dossier de pièces jointes partagé et vous en avez écrasé neuf sans bruit. C'est la façon la plus courante pour une migration de paraître terminée puis de perdre des figures des semaines plus tard, bien après que quiconque se souvient de la provenance de chaque fichier.
La conversion par lots contourne ce problème en donnant à chaque document source son propre sous-répertoire dans le ZIP : une note avec son dossier médias, puis la suivante, sans espace de noms partagé entre elles. Si vous voulez vraiment un dossier de pièces jointes unique pour tout le vault, fusionnez délibérément : renommez les images de chaque document avec un préfixe parlant, puis recherchez et remplacez les anciens chemins dans le Markdown.
Les formats qu'Obsidian ne peut pas afficher
Tout dans un docx n'est pas un PNG ou un JPEG. Les diagrammes Office, les collages Visio et certaines opérations de copie produisent des EMF et des WMF, des formats vectoriels Windows que les navigateurs ne peuvent pas décoder. Comme Obsidian repose sur la technologie des navigateurs, ces images restent invisibles, aussi corrects que soient les chemins, laissant souvent un trou en forme de figure dans la note.
Après décompression, triez le dossier médias par type de fichier et mettez de côté tout ce qui se termine par .emf ou .wmf. La solution la moins chère consiste à retourner au document source, à cliquer avec le bouton droit sur la figure et à choisir Save as picture (Enregistrer comme image) pour exporter un PNG avant la conversion. Renommez ensuite l'export pour qu'il corresponde à la référence, ou modifiez la référence pour qu'elle corresponde au fichier.