Solución de problemas
Imágenes no accesibles
Si las imágenes en tus archivos markdown muestran un indicador de "Concede permiso para ver" 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 Quick Look
Si las imágenes aparecen rotas o ausentes al previsualizar un archivo markdown con Quick Look (presionando Espacio en Finder), esto es una limitación de macOS — no un error de Peekdown.
Las extensiones de Quick Look 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 Quick Look — 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 Quick Look 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 Quick Look 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 Quick Look 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.
Peekdown no es compatible con extensiones específicas de GitHub como diagramas Mermaid o expresiones matemáticas (LaTeX).
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