Fehlerbehebung

Bilder nicht zugänglich

Wenn Bilder in deinen Markdown-Dateien einen „Ordnerzugriff gewähren, um dieses Bild anzuzeigen“- 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 du explizit die Berechtigung erteilt hast.

So behebst du das:

  1. Öffne Einstellungen > Ordner
  2. Schalte den Zugriff auf Standardordner (Schreibtisch, Dokumente, Downloads) ein, oder
  3. Klicke 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 der Übersicht nicht angezeigt

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

Übersicht-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 Übersicht-Erweiterungen — Peekdown kann dies nicht umgehen. Um Bilder korrekt gerendert zu sehen, öffne die Datei in Peekdown.

Importierte Anmerkungen werden nicht angezeigt

Wenn du eine Anmerkungsdatei importiert hast, die Anmerkungen aber nicht erscheinen, versuche, 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 du Anmerkungen importieren möchtest, die aus einer älteren Version von Peekdown exportiert wurden (.peekdown-Dateien), benenne 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 du eine Datei mit Anmerkungen schließt, 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 Übersicht-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): Übersicht-Vorschauen zeigen deine Anmerkungen an. Diese Abfrage erscheint nur einmal.

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

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

Änderungen werden nicht gespeichert

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

  • Überprüfe die Dateiberechtigungen im Finder: Klicke mit der rechten Maustaste auf die Datei, wähle Informationen und schau unter Teilen & Zugriffsrechte
  • Stelle sicher, dass du Schreibzugriff auf die Datei hast
  • Versuche, die Datei über Ablage > Sichern unter an einem anderen Ort zu sichern

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.

Mermaid-Diagramme und mathematische Ausdrücke (LaTeX) werden unterstützt und sind standardmäßig aktiviert — ein- oder ausschalten unter Einstellungen > Verhalten.

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 deinem Mac.

  • Deine 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