Das Probleme-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 Probleme-Panel öffnen
Klicken Sie ganz links in der Aktivitätsleiste auf das Symbol Probleme, um das Panel ein- oder auszublenden. Beim ersten Öffnen zeigt es eine Karte Referenzen prüfen an, mit der Sie eine Prüfung starten.
Referenzen prüfen
Referenzen prüfen durchsucht jede Markdown-Datei im Projekt und meldet Referenzen, 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 umbenannte oder gelöschte Datei)
- Ü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 Referenzen prüfen oder im Menü über Werkzeuge > Referenzen prüfen. Während der Prüfung zeigt das Panel den Fortschritt an; nach Abschluss erscheinen die Ergebnisse nach Datei gruppiert.
Die Ergebnisse lesen
Jede Datei mit einem Problem bildet eine Gruppe in der Baumansicht; beim Aufklappen werden alle defekten Referenzen dieser Datei aufgelistet. Jeder Eintrag zeigt:
- Die Zeilennummer, in der die Referenz vorkommt
- Den Referenztext so, wie er im Dokument steht
- Eine kurze Begründung — „Datei nicht gefunden“, „Überschrift … nicht gefunden“ oder den HTTP-Status einer nicht erreichbaren URL
Klicken Sie auf einen Eintrag, um die Datei zu öffnen und zur Zeile zu springen, damit Sie das Problem beheben können. Verwenden Sie nach Ihren Änderungen Erneut prüfen, um die Prüfung zu wiederholen und zu bestätigen, dass das Problem behoben ist.
Eine fehlende Datei mit „Neu verknüpfen“ beheben
Wenn ein Ergebnis ein Link oder Bild ist, der auf eine Datei verweist, die an diesem Ort nicht mehr existiert — zum Beispiel ein Bild, das Sie außerhalb von MarkNode verschoben haben —, bietet der Eintrag eine Schaltfläche Neu verknüpfen, damit Sie das Markdown nicht von Hand bearbeiten müssen.
Klicken Sie auf Neu verknüpfen, und MarkNode durchsucht das Projekt nach Dateien mit demselben Namen:
- Wird genau eine Übereinstimmung gefunden, schlägt MarkNode diese Datei vor — bestätigen Sie, um neu darauf zu verknüpfen.
- Werden mehrere gefunden, werden alle Treffer aufgelistet, sodass Sie den richtigen auswählen können.
- Wird keine gefunden, können Sie die Datei selbst an einer beliebigen Stelle innerhalb des Projekts auswählen.
Es ändert sich nichts, bis Sie eine Datei bestätigen. Sobald Sie das tun, wird die Referenz an Ort und Stelle aktualisiert und der Eintrag verschwindet aus den Ergebnissen.
Wann Sie es verwenden sollten
Eine Referenzprüfung lohnt sich vor allem, bevor Sie ein Dokument veröffentlichen oder weitergeben, nach einer Runde des Umbenennens oder Umorganisierens von Dateien oder wenn Sie Inhalte zwischen Dokumenten verschoben haben. Sie ergänzt den Hinweis auf einen defekten Link, den Sie direkt erhalten, wenn Sie auf einen nicht auflösbaren Link klicken — das Probleme-Panel findet alle derartigen Probleme im gesamten Projekt in einem Durchgang, statt eines nach dem anderen.