Problèmes

Le panneau Problèmes analyse votre projet à la recherche de problèmes faciles à manquer pendant la rédaction — les plus importants étant 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, partageant 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. Lors de sa 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 fonction 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 #ancre pointe vers un titre absent du document cible
• URL externe inaccessible — en option, 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 le déplier affiche toutes les références rompues 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 accéder directement à la ligne afin de la corriger. Après avoir effectué vos modifications, utilisez Réanalyser pour relancer la vérification et confirmer que le problème est résolu.

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 entre des documents. Cette fonction complète la notification de lien rompu affichée en ligne lorsque vous cliquez sur un lien qui ne se résout pas — le panneau Problèmes détecte tous ces problèmes dans l’ensemble du projet en une seule passe, plutôt qu’un par un.