Anmerkungen

Anmerkungen sind ein Rotstift für KI-Ausgaben. Wählen Sie gerenderten Text in der Vorschau aus und markieren Sie ihn mit Streichungen, Sperrungen, Kommentaren, Notizen und Blockanweisungen. Kopieren Sie dann Ihre Anmerkungen als strukturierten Prompt für jeden beliebigen KI-Assistenten.

Anmerkungen funktionieren nur im Anzeigemodus. Wechseln Sie in den Bearbeitungsmodus, um Änderungen selbst vorzunehmen, oder verwenden Sie Anmerkungen, um zu beschreiben, was ein KI-Tool ändern soll.

Anmerkungstypen

Es gibt fünf Anmerkungstypen:

Streichung — Wählen Sie Text aus und klicken Sie in der schwebenden Werkzeugleiste auf Streichung, oder drücken Sie S. Markiert den Text zum Löschen mit rotem Durchstreichen. Verwenden Sie dies, wenn Text vollständig entfernt werden soll.
Sperren — Wählen Sie Text aus und klicken Sie in der schwebenden Werkzeugleiste auf Sperren, oder drücken Sie L. Hebt den Text grün hervor, um ihn vor Änderungen zu schützen. Verwenden Sie dies, wenn Text genau so bleiben soll, wie er ist.
Kommentar — Wählen Sie Text aus und klicken Sie in der schwebenden Werkzeugleiste auf Kommentar, oder drücken Sie C, und geben Sie dann Ihren Vorschlag ein. Hebt den Text gelb hervor mit Ihrer angehängten Bearbeitungsanweisung. Verwenden Sie dies, wenn Text umgeschrieben oder geändert werden soll.
Notiz — Fügen Sie eine dokumentweite Notiz mit ⌘⇧N hinzu. Notizen sind nicht an bestimmten Text gebunden. Verwenden Sie sie für allgemeine Anweisungen wie „einen Abschlussabschnitt hinzufügen" oder „den Ton formeller gestalten".
Blocknotiz — Drücken Sie ⌘⇧B, um den Blocknotizmodus zu aktivieren. Blockelemente (Absätze, Überschriften, Listen, Codeblöcke) werden auswählbar. Klicken Sie auf einen Block und geben Sie dann eine Anweisung zum umgebenden Text ein. Verwenden Sie dies, um KI-Tools Anweisungen auf Blockebene zu geben.

Wenn Sie Text in der Vorschau auswählen, erscheint eine schwebende Werkzeugleiste mit Schaltflächen für Streichung, Sperren, Kommentar und Löschen. Sie können auch Tastaturkurzbefehle verwenden, während die Werkzeugleiste sichtbar ist: S für Streichung, L für Sperren, C für Kommentar, X zum Löschen der Anmerkung.

Anmerkungsleiste

Schalten Sie die Anmerkungsleiste mit ⌘⇧A oder der Symbolleisten-Schaltfläche um. Die Leiste ist ein integrierter Streifen, der unter der Titelleiste des Fensters eingeblendet wird, mit Schaltflächen für die Dokumentnotiz, Blocknotiz, Kopieren/Exportieren, Alle löschen und Fertig sowie einer Anzahl der Anmerkungen. Die Symbolleisten-Schaltfläche zeigt ein Abzeichen mit der Gesamtanzahl der Anmerkungen an.

Die Dokumentnotiz hat einen eigenen Bereich — klicken Sie auf das Notiz-Symbol in der Anmerkungsleiste, um ihn umzuschalten. Er erscheint als Haftnotiz unterhalb der Leiste, in der Sie Anweisungen eingeben können, die nicht an bestimmten Text gebunden sind.

Anmerkungen kopieren

Drücken Sie ⌘⌥⇧C, um Ihre Anmerkungen zu kopieren. Peekdown kopiert einen strukturierten Prompt in Ihre Zwischenablage, der alle Ihre Anmerkungen formatiert für KI-Assistenten enthält. Das Format verwendet ein JSON-Array, in dem jede Anmerkung ein type-Feld hat (delete, lock, comment, note oder blocknote) mit before- und after-Kontextfeldern, damit KI-Assistenten den genauen Text lokalisieren und analysieren können.

Fügen Sie den Prompt in den KI-Assistenten Ihrer Wahl ein — Claude Code, Cursor, ChatGPT, Claude.ai oder einen anderen. In einem Terminal leitet pbpaste | claude (oder das Äquivalent Ihres Tools) die Zwischenablage direkt in das Gespräch.

Nach dem Kopieren entfernt Peekdown die Anmerkungen aus Ihrem Dokument, damit die Antwort der KI auf eine saubere Version angewendet werden kann. Wenn Sie es sich anders überlegen — etwa weil die Bearbeitung der KI nicht passt — drücken Sie ⌘⌥⇧Z, wählen Sie Bearbeiten > Anmerkungen wiederherstellen oder klicken Sie auf die Wiederherstellen-Schaltfläche in der Anmerkungsleiste, um Ihre Anmerkungen zurückzuholen. Die Sicherung bleibt über Neustarts hinweg erhalten und überlebt das Schließen der Datei, sodass Sie auch Tage später wiederherstellen können. Jedes Kopieren erstellt eine neue Sicherung und ersetzt die vorherige.

Wiederherstellen wird automatisch verworfen, sobald sich das Dokument ändert. Wenn Ihr KI-Assistent die Bearbeitungen anwendet und die Datei speichert (oder Sie sie selbst bearbeiten), passt die Sicherung nicht mehr zum Dokument und Peekdown verwirft sie — die Wiederherstellen-Schaltfläche verschwindet und der Menüpunkt wird deaktiviert. Das ist beabsichtigt: Anmerkungen auf bearbeitetem Text wiederherzustellen würde sie an die falsche Stelle setzen. Wenn Sie eine dauerhafte Sicherung Ihrer Anmerkungen wünschen, unabhängig davon, was mit dem Dokument passiert, exportieren Sie sie zuerst über Bearbeiten > Anmerkungen exportieren (⌘⌥⇧E) — dadurch wird eine .json-Datei neben Ihrem Dokument erstellt, die Sie jederzeit wieder importieren können, auch nachdem das Dokument bearbeitet wurde.

Persistenz

Anmerkungen werden automatisch im App-Speicher unter ~/Library/Application Support/Peekdown/annotations/ gespeichert. Wenn Sie eine Datei erneut öffnen, werden ihre Anmerkungen automatisch wiederhergestellt. Wenn Sie zu einer anderen Datei mit nicht exportierten Anmerkungen wechseln, zeigt Peekdown eine Erinnerung an, dass Ihre Anmerkungen gespeichert sind und beim Zurückkehren wiederhergestellt werden.

Dateien importieren und exportieren

Sie können Anmerkungen über das Menü „Bearbeiten" in Standard-JSON-Dateien exportieren und daraus importieren.

Anmerkungen exportieren (Bearbeiten > Anmerkungen exportieren) speichert eine .json-Datei neben Ihrem Dokument. Die Namenskonvention ist dateiname.json — zum Beispiel werden Anmerkungen für notizen.md als notizen.json gespeichert. Die Datei ist eine Standard-JSON-Datei, sichtbar im Finder, die Sie mit Kollegen teilen oder neben Ihren Dokumenten sichern können.

Anmerkungen importieren (Bearbeiten > Anmerkungen importieren) öffnet einen Dateiauswahldialog für .json-Anmerkungsdateien. Sie können eine .json-Anmerkungsdatei auch per Drag-and-Drop direkt auf das Peekdown-Fenster ziehen, um sie zu importieren. Wenn Sie Anmerkungen importieren, werden sie im internen Speicher von Peekdown gespeichert. Ab diesem Zeitpunkt bleiben die Anmerkungen automatisch in Peekdown erhalten — Sie müssen die JSON-Datei nicht aufbewahren. Wenn Sie das Dokument schließen und später wieder öffnen, sind Ihre importierten Anmerkungen weiterhin vorhanden.

Dateiformat

Anmerkungsdateien verwenden JSON mit folgendem Schema:

{
  "annotations": [
    {
      "id": 1,
      "type": "strike",
      "text": "text to delete",
      "contextBefore": "preceding context",
      "contextAfter": "following context"
    },
    {
      "id": 2,
      "type": "lock",
      "text": "text to preserve",
      "contextBefore": "...",
      "contextAfter": "..."
    },
    {
      "id": 3,
      "type": "comment",
      "text": "text to change",
      "comment": "editing instruction",
      "contextBefore": "...",
      "contextAfter": "..."
    },
    {
      "id": 4,
      "type": "note",
      "text": "document-level instruction"
    },
    {
      "id": 5,
      "type": "blocknote",
      "text": "instruction for this block",
      "blockText": "the block this note applies to",
      "contextBefore": "...",
      "contextAfter": "..."
    }
  ],
  "nextId": 6,
  "hasUnexported": false,
  "exportedContentHash": "sha256-hex-string"
}

Das Feld type muss eines der folgenden sein: strike, lock, comment, note oder blocknote. Die Felder contextBefore und contextAfter verankern Anmerkungen am umgebenden Text, damit sie kleinere Bearbeitungen überstehen. Der exportedContentHash ermöglicht es Peekdown zu erkennen, wenn das Dokument nach dem Export von einem KI-Tool aktualisiert wurde.