Solución de problemas
Imágenes no accesibles
Si las imágenes en tus archivos markdown muestran un indicador de "Concede acceso a la carpeta para ver esta imagen" o "No se encuentra la imagen", Peekdown necesita permiso para acceder a la carpeta que contiene esas imágenes.
Peekdown se ejecuta en un sandbox seguro de macOS, lo que significa que solo puede acceder a archivos y carpetas a los que hayas concedido permiso explícitamente.
Para solucionarlo:
- Abre Ajustes > Carpetas
- Activa el acceso a carpetas comunes (Escritorio, Documentos, Descargas), o
- Haz clic en Añadir carpeta… para conceder acceso a una ubicación específica
La vista previa se recarga automáticamente una vez concedido el acceso.
Imágenes no se muestran en Vista rápida
Si las imágenes aparecen rotas o ausentes al previsualizar un archivo markdown con Vista rápida (presionando Espacio en Finder), esto es una limitación de macOS — no un error de Peekdown.
Las extensiones de Vista rápida se ejecutan en un sandbox restringido que solo tiene acceso al archivo que se está previsualizando. La extensión no puede leer otros archivos en disco, por lo que las imágenes locales referenciadas con rutas relativas (como ) no pueden cargarse.
Esta restricción la impone macOS y se aplica a todas las extensiones de Vista rápida — Peekdown no puede evitarla. Para ver las imágenes correctamente, abre el archivo en Peekdown.
Las anotaciones importadas no aparecen
Si importaste un archivo de anotaciones pero las anotaciones no aparecen, intenta cerrar y reabrir el documento. Las anotaciones importadas se guardan en el almacenamiento interno de Peekdown y deberían restaurarse automáticamente al reabrir el archivo.
Si intentas importar anotaciones exportadas desde una versión anterior de Peekdown (archivos .peekdown), renombra el archivo con extensión .json primero — el formato es el mismo, solo ha cambiado la extensión del archivo.
"Desea acceder a los datos de otras apps"
Al cerrar un archivo que tiene anotaciones, macOS puede mostrar una alerta que dice "Peekdown.app desea acceder a los datos de otras apps." Es una solicitud de privacidad estándar de macOS, no un error.
Por qué aparece: Peekdown guarda las anotaciones en un contenedor compartido para que la extensión Vista rápida pueda mostrarlas al previsualizar archivos en Finder. macOS Sequoia (15.0+) trata este acceso al contenedor compartido como intercambio de datos entre apps y muestra una solicitud de permiso única.
Permitir (recomendado): Las previsualizaciones de Vista rápida mostrarán tus anotaciones. Esta solicitud solo aparece una vez.
No permitir: La aplicación principal sigue funcionando con normalidad. El único efecto es que las previsualizaciones de Vista rápida no mostrarán las anotaciones.
Para cambiar esto después: Abre Ajustes del Sistema > Privacidad y seguridad > Datos de apps y activa o desactiva el acceso para Peekdown.
Los cambios no se guardan
Si tus cambios no se guardan, el archivo puede ser de solo lectura o estar en un directorio protegido:
- Comprueba los permisos del archivo en Finder: haz clic derecho en el archivo, selecciona Obtener información y revisa Compartir y permisos
- Asegúrate de que tienes acceso de escritura al archivo
- Intenta guardar en otra ubicación con Archivo > Guardar como
La vista previa no coincide con GitHub
Peekdown renderiza GitHub-Flavored Markdown (GFM) estándar, pero GitHub aplica procesamiento adicional para cosas como @menciones, enlaces a issues y funciones específicas del repositorio. Para contenido markdown puro, el renderizado debería ser idéntico.
Los diagramas Mermaid y las expresiones matemáticas (LaTeX) son compatibles y están activados por defecto — actívalos o desactívalos en Ajustes > Comportamiento.
Tamaño del texto
Si el texto aparece demasiado pequeño o grande:
- ⌘+ para acercar
- ⌘− para alejar
- ⌘⇧0 para restablecer al tamaño predeterminado
El nivel de zoom se recuerda por ventana.
Privacidad
Peekdown funciona completamente sin conexión. Nunca se conecta a internet — todo el renderizado de markdown ocurre localmente en tu Mac.
- Tus archivos se leen y escriben directamente en disco
- Las preferencias se almacenan localmente mediante los valores predeterminados de macOS
- Sin sincronización en la nube, sin cuentas, sin telemetría
- No se recopilan ni transmiten datos