Guía de usuario · Capítulo 01
Bienvenida y primer arranque
Te damos la bienvenida a Cocoa. Esta guía te acompaña por toda la app, en el orden en que la vas a ir conociendo: dónde viven tus notas, la ventana, la Library, tu primera nota, el formato, los marcadores, los archivos, las colecciones, el estudio, la búsqueda, los ajustes y qué hacer cuando algo sale mal. Aquí nada da por hecho que ya sabes dónde está cada botón.
Qué es Cocoa
Cocoa es una app de notas para Mac que se ve y se comporta como un cuaderno de papel. Cada nota es un documento continuo y paginado, dibujado sobre papel rayado. Las carpetas guardan cuadernos como un librero guarda carpetas de argollas. Los marcadores de colores resaltan palabras con significado — un término, una fórmula, algo que viene en el examen — y todo lo que marcas se reúne en listas y, si quieres, en tarjetas de estudio.
Por dentro, una nota es un simple archivo Markdown (.md) dentro de una carpeta que tú eliges. Puedes abrir esa carpeta en Finder cuando quieras, copiarla, respaldarla o moverla a iCloud Drive. Cocoa nunca esconde lo que escribes dentro de una base de datos.
La pantalla del primer arranque
- El encabezado "Welcome to Cocoa" con un icono de libro cerrado
- La tarjeta "Keep my notes in iCloud Drive" con su botón Use iCloud Drive
- La tarjeta "Keep my notes on this Mac" con su botón Use This Mac
- El enlace "I already have a Cocoa folder — open it…"
- La nota al pie sobre el índice de búsqueda y los respaldos, que se quedan en esta Mac
La primera vez que abres Cocoa todavía no hay nada que mostrar, así que toda la columna izquierda se convierte en una pantalla de bienvenida ①. Dice: "Your notes are plain Markdown files kept together in one folder. The only decision is where that folder lives." El lado derecho de la ventana muestra un panel vacío titulado No Vault (sin bóveda) con un icono de carpeta — eso es normal hasta que elijas.
Tienes tres opciones. Cada tarjeta dice exactamente qué va a pasar cuando le des clic, así que nada te toma por sorpresa.
Opción 1 — Guardar mis notas en iCloud Drive
La tarjeta izquierda ② es la opción destacada. Explica: "They sync to every Mac signed in to your Apple Account, and Apple keeps a copy."
Esto pasa cuando haces clic en Use iCloud Drive (usar iCloud Drive), el botón azul grande al final de la tarjeta:
- Se abre una ventana de carpetas, ya dentro de tu iCloud Drive.
- Hasta abajo de esa ventana, haz clic en Use This Folder.
- Cocoa crea ahí una carpeta llamada Cocoa y guarda todas tus notas en ella.
- En otra Mac, elige esta misma opción y selecciona esa carpeta Cocoa — aparecen las mismas notas.
Si esta Mac no parece tener sesión iniciada en iCloud, aparece un aviso dentro de la tarjeta: "This Mac does not look signed in to iCloud. If the window that opens is not iCloud Drive, sign in under System Settings › Apple Account › iCloud — or keep your notes on this Mac for now."
Opción 2 — Guardar mis notas en esta Mac
La tarjeta derecha ③ dice: "Nothing leaves this computer. You can move the folder into iCloud Drive later, and Cocoa will follow it."
Esto pasa cuando haces clic en Use This Mac (usar esta Mac), el botón con borde al final de la tarjeta:
- Se abre una ventana de carpetas en tu carpeta Documentos.
- Haz clic en Use This Folder.
- Cocoa crea ahí una carpeta llamada Cocoa y guarda todas tus notas en ella.
Opción 3 — Ya tengo una carpeta de Cocoa
Debajo de las dos tarjetas hay un botón en forma de enlace ④: I already have a Cocoa folder — open it…. Dale clic cuando estés configurando una segunda Mac, o restaurando desde un respaldo. Se abre un selector de carpetas con el mensaje "Choose a folder for your notes. Cocoa keeps them there as plain markdown files." Elige tu carpeta existente y haz clic en Choose.
La nota al pie ⑤ te recuerda: "Whichever you choose, the notes are ordinary files you can open in Finder. The search index and the daily backups stay on this Mac, outside that folder, so nothing but your notes is ever synced."
Qué pasa después: la lectura de la carpeta
En cuanto eliges una carpeta, Cocoa la lee. El lado derecho de la ventana muestra un indicador de actividad con las palabras Reading the folder…, y luego una cuenta en vivo como 12 files checked · 4 notes found, con la carpeta que se está leyendo en texto gris pequeño debajo. Bajo la cuenta hay un botón Stop.
- En una carpeta recién creada esto toma mucho menos de un segundo.
- Si apuntaste Cocoa a una carpeta con miles de archivos ajenos, haz clic en Stop. La carpeta sigue elegida, y entonces el panel dice: "Indexing was cancelled. Choose a smaller folder, or rebuild the index from the Help menu."
La advertencia de carpeta del sistema
Si la carpeta que elegiste es tu carpeta de inicio, el Escritorio, Descargas, Biblioteca, Aplicaciones, Películas, Música o Imágenes, aparece una alerta titulada That looks like a system folder. Explica que carpetas como Escritorio y Descargas guardan miles de archivos ajenos, y que Cocoa funciona mejor con una carpeta propia. Ofrece dos botones:
- Use It Anyway — sigue adelante con la carpeta que elegiste.
- Create a Notes Folder Instead — abre la ventana de la carpeta Documentos para que crees una carpeta de Cocoa como debe ser.
Cuando una carpeta no se puede abrir
Si algo sale mal — la carpeta no se puede leer, o la ruta ni siquiera es una carpeta — el lado derecho muestra Could Not Open That Folder con un triángulo de advertencia y el motivo exacto debajo (por ejemplo, "Cocoa is not a folder."). Siguen dos botones:
- Create My Notes Folder (azul) — crea una carpeta en Documentos, igual que la Opción 2.
- Choose Another Folder… (estilo enlace) — vuelve a abrir el selector de carpetas.
Aparece la Library
Cuando termina la lectura, el lado derecho de la ventana se convierte en la Library: una cuadrícula de carpetas dibujadas como carpetas de colores y notas dibujadas como pequeñas hojas. En una carpeta recién creada dice Your Library is Empty — Make a folder for a subject — Biology, Accounting — then notes inside it. con dos botones, New Note y New Folder. El capítulo 3 trata por completo sobre la Library.
El recorrido, y este manual
La primera vez que una carpeta está lista, un breve guided tour (recorrido guiado) comienza en la ventana principal y avanza solo. La primera tarjeta pide una sola cosa: Take the tour, o Skip. De ahí en adelante abre cada pantalla por turnos — la Library, tu carpeta y sus marcadores, una nota, su panel de archivos, el esquema y el inspector, los estantes de la carpeta, Write with AI — avisa cada vez que se mueve, e ilumina el control que está explicando mientras la tarjeta a su lado te dice para qué sirve. No hay nada que hacer más que leer; Next avanza, y Finish en el último paso te deja en la Library.
Tres veces el recorrido se detiene y te espera: para una carpeta, para un marcador dentro de ella y para una nota. La carpeta y la nota se crean desde el botón New de la Library, cuyo menú ofrece solo el elemento que pide el paso; el marcador, desde el botón Highlighters de la carpeta. Lo que sea que pida el paso se queda iluminado mientras todo lo demás en la ventana queda desactivado, y el recorrido continúa solo en cuanto la cosa existe.
- El control del que trata el paso, iluminado dentro de un anillo
- La tarjeta: el contador de pasos, qué hacer y el atajo
- Skip the tour, Back y Next (o Finish en el último paso)
- Skip the tour (arriba a la derecha de la tarjeta) lo termina. No pierdes nada; puedes tomarlo de nuevo cuando quieras.
- Next y Finish avanzan; Back regresa al paso anterior.
- Cuando el recorrido cambia de pantalla, primero aparece un aviso como "Opening a note" o "Showing the inspector", y una etiqueta en la tarjeta te muestra dónde estás.
Para tomar el recorrido otra vez: Help › Take the Tour (⌃⌥⌘/), el botón ? de la barra de herramientas › Take the Tour, o la paleta de comandos (⇧⌘P): escribe "tour".
Este manual es la versión larga, capítulo por capítulo. Ábrelo desde Help › User Guide (⌃⌘/), el botón ? de la barra de herramientas › User Guide, o la paleta: escribe "guide". Los botones que dicen Try it dentro de un capítulo actúan sobre la ventana principal mientras esta ventana sigue abierta; Previous y Next al final recorren los capítulos, y Done la cierra.
Un comienzo realista: una estudiante, un semestre
Maya empieza un semestre con cuatro materias y quiere todo en su laptop y en su computadora de escritorio. En la pantalla de bienvenida hace clic en Use iCloud Drive, ve su iCloud Drive en la ventana de carpetas, hace clic en Use This Folder, y se crea una carpeta Cocoa. Aparece la Library, vacía. En casa, en la Mac de escritorio, hace clic en I already have a Cocoa folder — open it…, elige la misma carpeta Cocoa dentro de iCloud Drive, y ahí están sus notas. El resto de esta guía sigue a Maya mientras arma sus cuadernos.
Resumen
- Las notas son simples archivos Markdown en una carpeta que tú eliges.
- La primera pantalla ofrece Use iCloud Drive, Use This Mac, o abrir una carpeta Cocoa existente; cada una abre una ventana de carpetas donde haces clic en Use This Folder.
- La lectura de la carpeta muestra el progreso y un botón Stop; los errores aparecen como Could Not Open That Folder con el motivo.
- El recorrido corre solo una vez; repítelo desde Help › Take the Tour (⌃⌥⌘/). Este manual es Help › User Guide (⌃⌘/).
Errores comunes
- Cerrar la ventana de carpetas sin hacer clic en Use This Folder — no se crea nada; simplemente elige de nuevo.
- Elegir la carpeta Escritorio o Descargas — Cocoa te advierte; elige Create a Notes Folder Instead.
- Esperar que las notas se sincronicen después de elegir Use This Mac — esa opción deja todo local; puedes mover la carpeta Cocoa a iCloud Drive más adelante.
- Saltarte el recorrido en el primer paso y luego andarlo buscando — está a un elemento de distancia, en Help › Take the Tour.
Buenas prácticas
- Usa iCloud Drive si escribes en más de una Mac; This Mac si no.
- Deja la carpeta con el nombre Cocoa, para que I already have a Cocoa folder — open it… la encuentre de inmediato en otra Mac.
- Deja que la carpeta termine de leerse antes de empezar; el primer índice es el lento, y cada arranque posterior es rápido.
- Toma el recorrido completo una vez. Son tres minutos y muestra todas las pantallas. Tres veces se detiene y te espera — para una carpeta, un marcador y una nota — así que en tu carpeta de notas no aparece nada que no hayas hecho tú; lo demás lo hace por ti.
Atajos de teclado usados
| Atajo | Qué hace |
|---|---|
| ⌃⌥⌘/ | Take the Tour |
| ⌃⌘/ | User Guide |
| ⇧⌘P | Command Palette… |
| ⌥⌘0 | Show / Hide Library |
Funciones relacionadas para aprender después
- Capítulo 2, La ventana principal — cada parte de la ventana que señaló el recorrido.
- Capítulo 13, Importar, exportar, respaldos y sincronización — qué significa iCloud Drive en el día a día.
- Capítulo 16, Solución de problemas y preguntas frecuentes — cuando la carpeta no abre.