Un fichier Markdown peut faire référence à une image sans contenir les données de cette image. Copier le seul fichier texte peut donc donner un document qui se lit bien, mais où les schémas laissent des blancs.
PDF Craft fournit les résultats Markdown sous forme d'archives ZIP. Extrayez l'archive complète avant de modifier ou de déplacer le document Markdown ; ouvrir seulement un aperçu à l'intérieur du ZIP masque le lien avec les images associées.
Repérer le document et ses dépendances
Téléchargez le ZIP depuis la tâche de conversion PDF vers Markdown terminée, puis extrayez-le dans un dossier dédié. L'archive contient le document Markdown et, lorsque des ressources d'image sont produites, le dossier qui les regroupe. Les noms d'export peuvent varier : le document peut reprendre le nom du fichier source ou s'appeler par exemple document.md, et les ressources se trouver sous images/ ou assets/. Ouvrez le fichier .md dans un éditeur de texte et suivez les liens qu'il contient réellement, plutôt que de renommer des dossiers pour les faire correspondre à un exemple. Conservez le ZIP d'origine comme copie intacte.
Une référence peut utiliser un chemin relatif, un chemin local absolu ou une URL distante. Ces formes n'ont pas la même portabilité. Avec un chemin relatif, la ressource doit conserver sa position par rapport au document ; avec une URL distante, il faut un accès réseau et la ressource doit rester accessible à cette adresse.
Vérifiez si les légendes et les numéros de figure sont du texte dans le document ou font partie de l'image. Conserver une image ne garantit pas que chaque mot qu'elle contient a été reconnu ou traduit. Le guide de relecture des images et des légendes traite de ces relations de contenu.
Lire un chemin relatif depuis l'emplacement du fichier Markdown
Le point essentiel est la relation entre un fichier Markdown et le dossier de ressources placé à côté. Voici un exemple simplifié avec des noms de document et d'image fictifs ; vérifiez les noms réels dans votre téléchargement :
paper/
├── notes.md
└── images/
└── figure-1.png
Le Markdown correspondant peut contenir :
L'éditeur cherche images/figure-1.png par rapport à notes.md. Déplacez le dossier paper entier et la relation peut rester intacte. Déplacez seulement notes.md et l'image risque de ne plus se trouver là où le lien l'attend.
La casse des noms de fichiers, les espaces, les extensions et les caractères encodés peuvent compter selon les systèmes. Une image visible sur un ordinateur peut ne plus s'afficher après transfert si le nom réel du fichier et le nom référencé ne correspondent pas.
Déplacer un dossier de travail complet
Gardez le téléchargement d'origine intact. Créez une copie de travail contenant le Markdown et toutes les ressources locales qu'il utilise, en préservant d'abord la structure. Ne réorganisez les fichiers qu'après avoir vérifié que le document s'affiche correctement avec la structure d'origine.
Si vous renommez un dossier de ressources, mettez à jour les liens correspondants et testez plusieurs figures. Évitez de réunir dans un même dossier les noms de fichiers génériques de plusieurs documents sans plan de nommage. Deux fichiers image1.png distincts peuvent s'écraser ou être confondus.
Lors d'un import dans une application de prise de notes, vérifiez si elle copie les pièces jointes ou se contente de pointer vers leur emplacement d'origine. Le guide d'import dans Obsidian décrit un flux externe. L'export de PDF Craft n'implique ni synchronisation automatique avec un coffre ni hébergement permanent des images.
Partager les fichiers, pas seulement l'aperçu
Si quelqu'un a besoin d'une copie locale portable, joignez le document et les ressources nécessaires, par exemple dans une archive de dossier créée avec votre gestionnaire de fichiers. Testez la copie partagée depuis un autre emplacement, sans vous fier aux chemins restés sur votre ordinateur.
Si vous publiez le Markdown sur un site web, respectez les règles de ce site en matière de téléversement de ressources et d'URL. Un chemin file:/// pointant vers votre appareil ne donnera pas accès au lecteur distant. Ne téléversez pas des figures sources privées sur un hébergement public dans le seul but de réparer un aperçu cassé.
Vérifiez que vous avez l'autorisation de partager le document et les illustrations. Une image convertie reste issue de son œuvre d'origine ; la conversion n'en fait pas une ressource librement réutilisable.
Diagnostiquer une image brisée, étape par étape
- Lisez le lien dans la source Markdown.
- Déterminez s'il attend un fichier local ou une URL distante.
- Vérifiez si ce fichier existe au chemin prévu, ou si l'adresse distante est accessible.
- Comparez le nom du fichier, la casse et l'extension.
- Ouvrez l'image elle-même pour écarter un fichier incomplet ou non pris en charge.
- Rouvrez le Markdown dans le lecteur prévu et examinez la légende et le contexte.
Si la ressource manque dans le téléchargement, comparez avec le PDF source et notez l'omission. Ne remplacez pas un schéma technique par une approximation générée. En attendant de retrouver le contenu manquant, conservez une référence claire à la page source.
Une fois les chemins fonctionnels, gardez le titre source, l'édition et l'emplacement des figures avec vos notes de recherche. Un document portable a besoin à la fois de liens utilisables et d'un moyen d'établir l'origine des images.