Blog Metlivi

Conserver les images d'un journal Markdown fonctionnelles après avoir déplacé le dossier

Pour éviter de casser les photos locales d'un journal Markdown lors de son déplacement, stockez les images dans le dossier du journal et créez un lien vers chacune d'elles avec un chemin relatif depuis la note qui l'utilise. Ensuite, déplacez ou copiez l'ensemble du dossier en préservant sa structure interne, ouvrez la note déplacée dans votre visionneuse Markdown habituelle et vérifiez que les images d'exemple s'affichent. Un chemin qui fonctionne dans un éditeur ne garantit pas que toutes les visionneuses le résoudront de la même manière.

30 septembre 20265 min readEsthétique du quotidien et expression personnellePar Metlivi Editorial Team
Section 1

Ce que signifie un chemin d'image relatif

La syntaxe des images en Markdown utilise un point d'exclamation, un texte alternatif entre crochets et une destination d'image entre parenthèses. Par exemple, ![A blue mug on the desk](../images/blue-mug.jpg) pointe vers une image en décrivant son emplacement par rapport au fichier Markdown. La spécification CommonMark illustre les destinations d'images telles que train.jpg, et le Markdown Guide documente la même syntaxe de base. CommonMark: Images Markdown Guide: Basic Syntax

Un chemin relatif est pratique pour déplacer un journal car il décrit une relation entre des fichiers, plutôt que de désigner un emplacement particulier sur un ordinateur donné. Si la note et l'image sont déplacées ensemble sans modifier cette relation, le chemin pointe toujours vers la même image. Un emplacement absolu tel que /Users/sam/Pictures/blue-mug.jpg ou C:\Users\Sam\Pictures\blue-mug.jpg désigne un emplacement spécifique sur une machine ; copier le journal sur un autre disque ou un autre ordinateur peut le rendre invalide.

Section 2

Choisir une structure de dossier qui se déplace d'un seul bloc

Pour un journal dont les notes sont organisées par année, une disposition pratique consiste à conserver un dossier d'images partagé aux côtés des dossiers d'années :

text Diary/ ├── images/ │ ├── blue-mug.jpg │ └── garden-bed.png ├── 2025/ │ └── 2025-04-12.md └── 2026/ └── 2026-09-30.md

Depuis Diary/2026/2026-09-30.md, le chemin vers blue-mug.jpg est ../images/blue-mug.jpg : remontez d'un répertoire depuis 2026, puis entrez dans images. La ligne Markdown pourrait être :

md ![Blue mug beside the open diary](../images/blue-mug.jpg)

Si les images de chaque année n'appartiennent qu'à cette année-là, un sous-dossier adjacent est également facile à appréhender :

text Diary/ ├── 2026/ │ ├── images/ │ │ └── garden-bed.png │ └── 2026-09-30.md

La note peut alors utiliser ![Garden bed after planting](images/garden-bed.png). Ces exemples dépendent de l'emplacement de la note affichée. Comptez les répertoires entre la note et l'image ; ne devinez pas le nombre de segments ../.

Section 3

Écrire le lien du point de vue de la note

Commencez par le dossier du fichier Markdown, puis parcourez l'arborescence des répertoires jusqu'à l'image. Une destination se limitant au nom de fichier, comme photo.jpg, signifie que l'image se trouve à côté de la note. images/photo.jpg signifie qu'elle se trouve dans un sous-dossier images à côté de la note. ../images/photo.jpg signifie qu'il faut d'abord remonter d'un niveau. Cette règle offre un moyen concret de calculer le lien avant de l'essayer dans la visionneuse.

Privilégiez des noms simples quand c'est possible : par exemple, 2026-09-30-garden.jpg. L'orthographe exacte et les majuscules/minuscules comptent sur de nombreux systèmes de fichiers, et une faute de frappe ou une discordance de casse peut suffire à rendre une image indisponible. Les espaces et la ponctuation peuvent également être traités différemment selon les applications Markdown. Le Markdown Guide note que les applications ne gèrent pas toutes les espaces dans les URL de la même façon et recommande %20 pour des raisons de compatibilité. Si le nom d'une image contient des espaces, un nom de fichier simple évite cette incertitude ; sinon, utilisez le style d'encodage ou de guillemets pris en charge par votre visionneuse et vérifiez-le sur place. Markdown Guide: Link Best Practices

Section 4

Déplacer le journal sans modifier son plan interne

Considérez le dossier du journal comme une unité. Copiez ou déplacez le dossier englobant Diary/ avec à la fois les notes .md et les images, plutôt que de ne déplacer que les notes ou d'abandonner les images. Les chemins relatifs résistent à un changement de l'emplacement externe du dossier car leur point de départ et leur destination internes conservent la même relation.

Lors de la réorganisation des dossiers à l'intérieur du journal, recalculez les liens pour les notes concernées. Par exemple, déplacer une note de Diary/2026/ vers Diary/2026/trips/ modifie le chemin nécessaire pour atteindre Diary/images/ : elle nécessite désormais ../../images/blue-mug.jpg. Un lien relatif prend en charge le déplacement de l'arborescence complète, mais il ne peut pas compenser automatiquement le réaménagement d'une seule partie de cette arborescence.

Section 5

Tester un déplacement réel dans la visionneuse que vous utilisez

Effectuez une petite vérification réversible avant de vous fier à une nouvelle disposition de dossiers :

Choisissez une note contenant au moins une image locale et confirmez que l'image s'affiche bien dans votre visionneuse Markdown habituelle.

Copiez le dossier complet du journal vers un autre emplacement, tel qu'un autre dossier classique ou un lecteur amovible. Préservez tous les sous-dossiers et noms de fichiers.

Ouvrez la note copiée depuis son nouvel emplacement dans la même visionneuse. Confirmez que l'image apparaît, et pas seulement que le code source Markdown contient le texte attendu.

Ouvrez une ou deux images dans des notes situées à différentes profondeurs, en particulier les notes utilisant ../. Cela permet de vérifier plus qu'un simple exemple situé dans le même dossier.

Si une image est manquante, comparez la destination avec l'arborescence réelle des dossiers : vérifiez le dossier de départ de la note, chaque ../, chaque nom de sous-dossier, l'orthographe du nom de fichier, l'extension et la casse. Corrigez le chemin, puis répétez la vérification sur la copie déplacée.

Il s'agit d'un test pratique, pas d'une garantie universelle sur toutes les applications. Le Markdown standard décrit la syntaxe des images, mais les visionneuses peuvent ajouter leurs propres conventions. Par exemple, Obsidian documente à la fois la syntaxe d'image Markdown et sa propre syntaxe d'intégration (![[image.jpg]]), et ses paramètres décrivent séparément les formats de liens relatifs, à la racine du coffre et au chemin le plus court. Si votre journal est ouvert dans une application basée sur un coffre (vault), vérifiez si vous utilisez des destinations Markdown standard ou des intégrations et paramètres de liens propres à l'application. Obsidian Help: Embed files Obsidian Help: Settings

Section 6

Diagnostiquer une image cassée après le déplacement

Si l'image disparaît, déterminez d'abord quelle copie de la note a été ouverte par la visionneuse. Il est facile d'inspecter la note d'origine en croyant regarder la note déplacée. Ensuite, suivez manuellement le chemin relatif depuis le répertoire de cette note et confirmez que l'image désignée existe bien à destination.

Un moyen rapide de cerner le problème est de comparer temporairement le chemin avec l'arborescence des dossiers : si 2026-09-30.md se trouve dans Diary/2026/, ../images/blue-mug.jpg doit pointer vers Diary/images/blue-mug.jpg. Si le chemin mène bien au dossier souhaité mais que le fichier s'appelle Blue-Mug.JPG, mettez à jour la référence du nom de fichier ou le nom du fichier pour qu'ils correspondent exactement. Si l'image s'ouvre dans un gestionnaire de fichiers mais ne s'affiche pas dans la note, le problème restant peut venir de la façon dont cette visionneuse gère les chemins Markdown locaux ; vérifiez dans sa documentation ou testez une destination d'image Markdown simple.

Section 7

Une règle simple de portabilité

Conservez les images locales du journal sous le dossier racine de celui-ci, écrivez chaque chemin d'image de manière relative par rapport à la note qui l'affiche, et préservez la structure des dossiers lors du déplacement du journal. Enfin, ouvrez la copie déplacée dans la visionneuse réelle et confirmez que les images représentatives s'affichent. Cette routine vérifie à la fois la relation entre les fichiers et le comportement de l'application, ce qui garantit la fiabilité d'une configuration portable au quotidien.

À lire aussi

Continuer sur ce thème