Das Problembereich-Panel durchsucht Ihr Projekt nach Problemen, die beim Schreiben leicht übersehen werden — allen voran Links und Bilder, die auf etwas verweisen, das nicht mehr existiert. Es ist ein angedocktes Panel am unteren Rand des Fensters und teilt sich diesen Bereich mit dem Terminal und dem Suchen-Panel.
Das Problembereich-Panel öffnen
Klicken Sie auf das Symbol Probleme in der Aktivitätsleiste ganz links, um das Panel ein- oder auszublenden. Beim ersten Öffnen zeigt es eine Karte Verweise prüfen an, über die Sie eine Prüfung starten.
Verweise prüfen
Verweise prüfen durchsucht jede Markdown-Datei im Projekt und meldet Verweise, die nicht aufgelöst werden können. Erkannt werden:
- Datei nicht gefunden — ein Link oder Bild verweist auf eine Datei, die nicht existiert (zum Beispiel eine Datei, die umbenannt oder gelöscht wurde)
- Überschrift nicht gefunden — ein
#anchor-Link verweist auf eine Überschrift, die im Zieldokument nicht vorhanden ist - Nicht erreichbare externe URL — optional ein externer Link, der einen Fehler zurückgibt, angezeigt mit seinem HTTP-Status
Starten Sie eine Prüfung über die Karte Verweise prüfen oder über Werkzeuge > Verweise prüfen im Menü. Während die Prüfung läuft, zeigt das Panel den Fortschritt an; nach Abschluss erscheinen die Ergebnisse nach Datei gruppiert.
Die Ergebnisse lesen
Jede Datei, die ein Problem enthält, wird zu einer Gruppe in der Baumansicht; beim Aufklappen werden alle fehlerhaften Verweise in dieser Datei aufgelistet. Jeder Eintrag zeigt:
- Die Zeilennummer, in der der Verweis auftritt
- Den Verweistext so, wie er im Dokument steht
- Eine kurze Begründung — „Datei nicht gefunden“, „Überschrift … nicht gefunden“ oder den HTTP-Status bei einer nicht erreichbaren URL
Klicken Sie auf einen Eintrag, um die Datei zu öffnen und zur betreffenden Zeile zu springen, damit Sie das Problem beheben können. Verwenden Sie nach Ihren Änderungen Erneut prüfen, um die Prüfung noch einmal auszuführen und zu bestätigen, dass das Problem behoben ist.
Wann Sie es verwenden sollten
Die Prüfung der Verweise ist besonders nützlich vor dem Veröffentlichen oder Teilen eines Dokuments, nach einer Runde des Umbenennens oder Neuordnens von Dateien oder wenn Sie Inhalte zwischen Dokumenten verschoben haben. Sie ergänzt den Inline-Hinweis auf fehlerhafte Links, den Sie erhalten, wenn Sie auf einen nicht auflösbaren Link klicken — das Problembereich-Panel findet alle derartigen Probleme im gesamten Projekt in einem einzigen Durchgang, statt eines nach dem anderen.