Le panneau Problèmes analyse votre projet à la recherche de problèmes faciles à manquer pendant la rédaction — en particulier les liens et les images qui pointent vers quelque chose qui n’existe plus. Il s’agit d’un panneau ancré en bas de la fenêtre, qui partage cette zone avec le Terminal et le panneau Rechercher.
Ouvrir le panneau Problèmes
Cliquez sur l’icône Problèmes dans la barre d’activité tout à gauche pour afficher ou masquer le panneau. À la première ouverture, il affiche une carte Vérifier les références permettant de lancer une analyse.
Vérifier les références
Vérifier les références analyse chaque fichier Markdown du projet et signale les références qui ne peuvent pas être résolues. Cette commande détecte :
- Fichier introuvable — un lien ou une image pointe vers un fichier qui n’existe pas (par exemple, un fichier renommé ou supprimé)
- Titre introuvable — un lien
#ancrepointe vers un titre absent du document cible - URL externe inaccessible — éventuellement, un lien externe qui renvoie une erreur, affiché avec son statut HTTP
Lancez une analyse depuis la carte Vérifier les références, ou depuis Outils > Vérifier les références dans le menu. Pendant l’analyse, le panneau affiche la progression ; une fois terminée, les résultats apparaissent regroupés par fichier.
Lire les résultats
Chaque fichier contenant un problème devient un groupe dans l’arborescence, et son développement liste chaque référence brisée de ce fichier. Chaque entrée indique :
- Le numéro de ligne où apparaît la référence
- Le texte de la référence tel qu’il est écrit dans le document
- Une brève raison — « fichier introuvable », « titre … introuvable », ou le statut HTTP pour une URL inaccessible
Cliquez sur une entrée pour ouvrir le fichier et vous rendre directement à la ligne concernée afin de la corriger. Après vos modifications, utilisez Réanalyser pour relancer la vérification et confirmer que le problème est résolu.
Corriger un fichier manquant avec Relier
Lorsqu’un résultat correspond à un lien ou une image pointant vers un fichier qui ne se trouve plus à cet emplacement — par exemple, une image que vous avez déplacée en dehors de MarkNode — son entrée propose un bouton Relier, ce qui vous évite de modifier le Markdown à la main.
Cliquez sur Relier : MarkNode recherche alors dans le projet les fichiers portant le même nom.
- S’il trouve exactement une correspondance, il suggère ce fichier — confirmez pour y relier la référence.
- S’il en trouve plusieurs, il les liste toutes afin que vous puissiez choisir la bonne.
- S’il n’en trouve aucune, il vous permet de rechercher vous-même le fichier, n’importe où dans le projet.
Rien ne change tant que vous n’avez pas confirmé un fichier. Une fois fait, la référence est mise à jour sur place et l’entrée disparaît des résultats.
Quand l’utiliser
Vérifier les références est particulièrement utile avant de publier ou de partager un document, après une série de renommages ou de réorganisations de fichiers, ou lorsque vous avez déplacé du contenu d’un document à l’autre. Cette commande complète la notification de lien brisé qui s’affiche lorsque vous cliquez sur un lien qui ne se résout pas — le panneau Problèmes repère toutes les anomalies de ce type dans l’ensemble du projet en une seule passe, au lieu de les traiter une par une.