Fehlerbehebung

Bilder nicht zugänglich

Wenn Bilder in Ihren Markdown-Dateien einen „Berechtigung zum Anzeigen erteilen"- oder „Bild nicht gefunden"-Platzhalter zeigen, benötigt Peekdown die Berechtigung, auf den Ordner zuzugreifen, der diese Bilder enthält.

Peekdown läuft in einer sicheren macOS-Sandbox, was bedeutet, dass es nur auf Dateien und Ordner zugreifen kann, für die Sie explizit die Berechtigung erteilt haben.

So beheben Sie das:

  1. Öffnen Sie Einstellungen > Ordner
  2. Schalten Sie den Zugriff auf Standardordner (Schreibtisch, Dokumente, Downloads) ein, oder
  3. Klicken Sie auf Ordner hinzufügen …, um den Zugriff auf einen bestimmten Speicherort zu gewähren

Die Vorschau wird automatisch neu geladen, sobald der Zugriff gewährt wird.

Bilder werden in Quick Look nicht angezeigt

Wenn Bilder beim Vorschauen einer Markdown-Datei mit Quick Look (Leertaste im Finder) defekt erscheinen oder fehlen, handelt es sich um eine macOS-Einschränkung — nicht um einen Peekdown-Fehler.

Quick Look-Erweiterungen laufen in einer eingeschränkten Sandbox, die nur Zugriff auf die vorgeschaute Datei hat. Die Erweiterung kann keine anderen Dateien auf der Festplatte lesen, sodass lokale Bilder mit relativen Pfaden (wie ![foto](./bilder/foto.png)) nicht geladen werden können.

Diese Einschränkung wird von macOS erzwungen und gilt für alle Quick Look-Erweiterungen — Peekdown kann dies nicht umgehen. Um Bilder korrekt gerendert zu sehen, öffnen Sie die Datei in Peekdown.

Importierte Anmerkungen werden nicht angezeigt

Wenn Sie eine Anmerkungsdatei importiert haben, die Anmerkungen aber nicht erscheinen, versuchen Sie, das Dokument zu schließen und erneut zu öffnen. Importierte Anmerkungen werden im internen Speicher von Peekdown gespeichert und sollten beim erneuten Öffnen der Datei automatisch wiederhergestellt werden.

Wenn Sie Anmerkungen importieren möchten, die aus einer älteren Version von Peekdown exportiert wurden (.peekdown-Dateien), benennen Sie die Datei zuerst mit der Endung .json um — das Format ist dasselbe, nur die Dateiendung hat sich geändert.

„Möchte auf Daten anderer Apps zugreifen"

Wenn Sie eine Datei mit Anmerkungen schließen, zeigt macOS möglicherweise eine Meldung an: „Peekdown.app möchte auf Daten anderer Apps zugreifen." Dies ist eine standardmäßige macOS-Datenschutzabfrage, kein Fehler.

Warum diese Meldung erscheint: Peekdown speichert Anmerkungen in einem gemeinsamen Container, damit die Quick Look-Erweiterung sie beim Vorschauen von Dateien im Finder anzeigen kann. macOS Sequoia (15.0+) behandelt diesen Zugriff auf den gemeinsamen Container als App-übergreifenden Datenaustausch und zeigt eine einmalige Berechtigungsabfrage an.

Erlauben (empfohlen): Quick Look-Vorschauen zeigen Ihre Anmerkungen an. Diese Abfrage erscheint nur einmal.

Nicht erlauben: Die Hauptanwendung funktioniert weiterhin normal. Der einzige Effekt ist, dass Quick Look-Vorschauen keine Anmerkungen anzeigen.

Um dies später zu ändern: Öffnen Sie Systemeinstellungen > Datenschutz & Sicherheit > App-Daten und schalten Sie den Zugriff für Peekdown ein oder aus.

Änderungen werden nicht gespeichert

Wenn Ihre Änderungen nicht gespeichert werden, ist die Datei möglicherweise schreibgeschützt oder befindet sich in einem geschützten Verzeichnis:

  • Überprüfen Sie die Dateiberechtigungen im Finder: Klicken Sie mit der rechten Maustaste auf die Datei, wählen Sie Informationen und schauen Sie unter Teilen & Berechtigungen
  • Stellen Sie sicher, dass Sie Schreibzugriff auf die Datei haben
  • Versuchen Sie, an einem anderen Ort zu speichern über Ablage > Sichern unter

Vorschau stimmt nicht mit GitHub überein

Peekdown rendert Standard GitHub-Flavored Markdown (GFM), aber GitHub wendet zusätzliche Verarbeitung für Dinge wie @Erwähnungen, Issue-Links und repository-spezifische Funktionen an. Für reinen Markdown-Inhalt sollte die Darstellung identisch sein.

Peekdown unterstützt keine GitHub-spezifischen Erweiterungen wie Mermaid-Diagramme oder mathematische Ausdrücke (LaTeX).

Textgröße

Wenn Text zu klein oder zu groß erscheint:

  • ⌘+ zum Vergrößern
  • ⌘− zum Verkleinern
  • ⌘0 zum Zurücksetzen auf die Standardgröße

Die Zoomstufe wird pro Fenster gespeichert.

Datenschutz

Peekdown ist vollständig offline. Es stellt niemals eine Verbindung zum Internet her — die gesamte Markdown-Darstellung erfolgt lokal auf Ihrem Mac.

  • Ihre Dateien werden direkt auf der Festplatte gelesen und geschrieben
  • Einstellungen werden lokal über macOS-Standardeinstellungen gespeichert
  • Keine Cloud-Synchronisation, keine Konten, keine Telemetrie
  • Es werden keine Daten erfasst oder übertragen