Anotaciones

Las anotaciones son un bolígrafo rojo para la salida de IA. Selecciona texto renderizado en la vista previa y márcalo con tachaduras, bloqueos, comentarios, notas e instrucciones de bloque, luego copia tus anotaciones como un prompt estructurado para cualquier asistente de IA.

Las anotaciones funcionan solo en modo visor. Entra en modo de edición para hacer cambios tú mismo, o usa anotaciones para describir lo que una herramienta de IA debería cambiar.

Tipos de anotación

Hay cinco tipos de anotación:

• Tachadura — Selecciona texto y haz clic en Tachadura en la barra flotante, o presiona S. Marca el texto para eliminación con un tachado rojo. Úsalo cuando el texto debe eliminarse por completo.
• Bloquear — Selecciona texto y haz clic en Bloquear en la barra flotante, o presiona L. Resalta el texto en verde para protegerlo de cambios. Úsalo cuando el texto debe permanecer exactamente como está.
• Comentario — Selecciona texto y haz clic en Comentario en la barra flotante, o presiona C, luego escribe tu sugerencia. Resalta el texto en amarillo con tu instrucción de edición adjunta. Úsalo cuando el texto debe reescribirse o modificarse.
• Nota — Añade una nota a nivel de documento con ⌘⇧N. Las notas no están vinculadas a texto específico. Úsalas para instrucciones generales como "añadir una sección de conclusión" o "cambiar el tono para que sea más formal".
• Nota de bloque — Presiona ⌘⇧B para entrar en modo de nota de bloque. Los elementos a nivel de bloque (párrafos, encabezados, listas, bloques de código) se vuelven seleccionables. Haz clic en un bloque, luego escribe una instrucción sobre el texto circundante. Úsalo para dar indicaciones a nivel de bloque a herramientas de IA.

Cuando seleccionas texto en la vista previa, aparece una barra flotante con botones para Tachadura, Bloquear, Comentario y Eliminar. También puedes usar atajos de teclado mientras la barra es visible: S para tachadura, L para bloquear, C para comentario, X para eliminar la anotación.

Barra de anotaciones

Alterna la barra de anotaciones con ⌘⇧A o el botón de la barra de herramientas. La barra es una franja integrada que se despliega debajo de la barra de título de la ventana con botones para la nota del documento, nota de bloque, copiar/exportar, eliminar todo y cerrar, además de un recuento de anotaciones. El botón de la barra de herramientas muestra una insignia con el recuento total de anotaciones.

La nota del documento tiene su propio panel — haz clic en el icono de nota en la barra de anotaciones para alternarla. Aparece como una nota adhesiva debajo de la barra donde puedes escribir instrucciones que no están vinculadas a texto específico.

Copiar anotaciones

Presiona ⌘⌥⇧C para copiar tus anotaciones. Peekdown copia un prompt estructurado a tu portapapeles que incluye todas tus anotaciones formateadas para asistentes de IA. El formato usa un array JSON donde cada anotación tiene un campo type (delete, lock, comment, note o blocknote) con campos de contexto before y after para que los asistentes de IA puedan localizar e interpretar el texto exacto.

Pega el prompt en el asistente de IA que uses — Claude Code, Cursor, ChatGPT, Claude.ai o cualquier otro. En un terminal, pbpaste | claude (o el equivalente de tu herramienta) envía el portapapeles directamente a la conversación.

Después de copiar, Peekdown borra las anotaciones del documento para que la respuesta de la IA se pueda aplicar a una versión limpia. Si cambias de opinión — por ejemplo, si la edición de la IA no es lo que querías — presiona ⌘⌥⇧Z, elige Edición > Restaurar anotaciones, o haz clic en el botón Restaurar en la barra de anotaciones para recuperarlas. La copia de seguridad persiste entre reinicios y sobrevive al cerrar el archivo, así que puedes restaurar incluso días después. Cada Copiar crea una nueva copia de seguridad, reemplazando la anterior.

Restaurar se descarta automáticamente cuando el documento cambia. Si tu asistente de IA aplica las ediciones y guarda el archivo (o lo editas tú mismo), la copia de seguridad ya no coincide con el documento y Peekdown la descarta — el botón Restaurar desaparece y el elemento del menú se desactiva. Esto es intencional: restaurar anotaciones sobre texto modificado las pondría en el lugar equivocado. Si quieres una copia de seguridad permanente de tus anotaciones independientemente de lo que le pase al documento, exportalas primero mediante Edición > Exportar anotaciones (⌘⌥⇧E) — eso crea un archivo .json junto a tu documento que puedes reimportar en cualquier momento, incluso después de que el documento haya sido editado.

Persistencia

Las anotaciones se guardan automáticamente en el almacenamiento de la aplicación en ~/Library/Application Support/Peekdown/annotations/. Cuando reabres un archivo, sus anotaciones se restauran automáticamente. Cuando cambias a un archivo diferente con anotaciones no exportadas, Peekdown muestra un recordatorio de que tus anotaciones están guardadas y se restaurarán cuando regreses.

Importar y exportar archivos

Puedes exportar anotaciones a archivos JSON estándar e importarlas desde ellos usando el menú Edición.

Exportar anotaciones (Edición > Exportar anotaciones) guarda un archivo .json junto a tu documento. La convención de nombres es nombre-del-archivo.json — por ejemplo, las anotaciones para notas.md se guardan como notas.json. El archivo es un JSON estándar, visible en Finder, que puedes compartir con colaboradores o respaldar junto a tus documentos.

Importar anotaciones (Edición > Importar anotaciones) abre un selector de archivos para archivos de anotaciones .json. También puedes arrastrar y soltar un archivo de anotaciones .json directamente sobre la ventana de Peekdown para importarlo. Cuando importas anotaciones, se guardan en el almacenamiento interno de Peekdown. A partir de ese momento, las anotaciones persisten en Peekdown automáticamente — no necesitas conservar el archivo JSON. Si cierras y reabres el documento más tarde, tus anotaciones importadas seguirán ahí.

Formato del archivo

Los archivos de anotaciones usan JSON con el siguiente esquema:

{
  "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"
}

El campo type debe ser uno de: strike, lock, comment, note o blocknote. Los campos contextBefore y contextAfter anclan las anotaciones al texto circundante para que sobrevivan a ediciones menores. El campo exportedContentHash permite a Peekdown detectar cuando el documento ha sido actualizado por una herramienta de IA después de la exportación.