> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Usar las notas
> Escribe notas en tarjetas desde la ventana del Chatbot: se guardan como archivos Markdown locales, se pueden buscar, la IA las lee y las escribe, y se abren con cualquier editor.
## Qué son las notas
Las **notas** de Linkly AI son una sucesión de tarjetas ordenadas en el tiempo: escribes una frase en el cuadro de texto de abajo, pulsas para guardar y al instante se convierte en una tarjeta más de la línea temporal.
La gran diferencia con cualquier otra aplicación de notas es que **cada tarjeta es un archivo `.md` corriente en tu disco**. No hay base de datos propietaria ni función de exportación (porque no hace falta): puedes abrirlas cuando quieras con Obsidian o VS Code, o pasarles directamente un `grep`. Al mismo tiempo, Linkly AI las indexa, así que se pueden buscar y tu asistente de IA puede leerlas y escribirlas.
El cuadro de texto está siempre abajo: escribes, pulsas ⌘/Ctrl+Enter y listo, sin crear archivos ni inventar títulos
Markdown estándar con cabecera YAML: cualquier editor los lee y los modifica, y siguen ahí aunque borres la aplicación
### Para qué van bien
Las notas están pensadas para ser **cortas, rápidas y fáciles de recuperar después**, no para escribir textos largos:
* **Lo que se te acaba de ocurrir**: una tarea de una línea, una idea de producto que aparece de golpe
* **Anotaciones mientras lees documentos**: mientras la IA busca material, tú vas apuntando las conclusiones
* **Conclusiones que deja la IA**: pídele al Chatbot que lea un conjunto de material y escriba los puntos clave como una nota
* **Un sitio donde aterrizan los datos sueltos**: una cifra que oíste en una reunión, un libro que te recomendaron
Si lo que vas a escribir es un documento en condiciones, es mejor crear un archivo Markdown directamente en la carpeta `~/LinklyAI`: también se indexa.
***
## Abrir las notas
Las notas **no son una ventana aparte**, sino una vista dentro de la ventana del Chatbot, al mismo nivel que la conversación:
* Pulsa el botón **Notas** de la barra lateral del Chatbot
* O usa **⌘⇧N** (en Windows / Linux: **Ctrl+Shift+N**)
**⌘⇧N no es un atajo global**: la ventana del Chatbot tiene que estar en primer plano y con el foco para que responda. El único atajo global de toda la aplicación es **⌘⇧L / Ctrl+Shift+L**, que abre el [lanzador de búsqueda](/docs/es/use-launcher).
***
## Escribir la primera nota
La vista de notas tiene abajo un cuadro de texto siempre visible, con el texto de ayuda «Escribe una nota… Usa #tag para etiquetarla».
Si el texto se alarga, pulsa el botón de expandir de la esquina superior derecha y el cuadro **crece hacia arriba en el mismo sitio** (hasta el 60 % de la ventana), sin abrir ninguna ventana nueva y sin afectar al borrador ni a la posición del cursor.
Pulsa **⌘/Ctrl+Enter** o el botón de enviar de la esquina inferior derecha. La tarjeta aparece de inmediato al final de la línea temporal.
Pulsar Enter a secas inserta un salto de línea y no guarda nada. Es intencionado: las notas suelen ocupar varias líneas.
Pulsa **Editar** en la tarjeta y esta **pasa a modo editable en su sitio**, sin cuadros de diálogo. Solo se puede editar una tarjeta a la vez.
Al terminar hay que pulsar **Guardar** o ⌘/Ctrl+Enter.
Menú `⋯` de la esquina superior derecha de la tarjeta → Eliminar → confirmación.
**Eliminar borra definitivamente ese archivo del disco**: no pasa por la papelera y la aplicación no ofrece deshacer. El cuadro de confirmación lo dice sin rodeos: «El archivo de la nota se eliminará permanentemente del disco. No se puede deshacer.»
### Qué permite el editor
El editor de notas es un **campo de texto Markdown puro**, no un editor enriquecido: lo que ves es el código fuente. La barra de herramientas tiene solo 5 botones:
| Botón | Qué hace |
| ----------------- | ------------------------------------------------------------------ |
| Negrita | Rodea el texto seleccionado con `**` |
| Tachado | Rodea el texto seleccionado con `~~` |
| Lista con viñetas | Convierte las líneas seleccionadas en una lista con `-` |
| Lista numerada | Convierte las líneas seleccionadas en una lista con `1.` |
| Insertar tag | Inserta `#` en el cursor y abre a la vez el autocompletado de tags |
**No hay** botones de cursiva, encabezados, enlaces ni bloques de código: es una limitación deliberada, porque las notas tienen que ser breves. Dentro de una lista, pulsar Enter continúa automáticamente con el siguiente elemento.
Una vez guardada, la tarjeta pasa a modo lectura y el Markdown se renderiza con normalidad.
**No hay guardado automático.** Lo que hay en el cuadro de texto y en el editor vive solo en memoria: si cambias a la vista de conversación y vuelves, el borrador sigue ahí, pero **al cerrar la aplicación se pierde**. Acuérdate de pulsar ⌘/Ctrl+Enter al terminar.
En modo lectura **las imágenes no se cargan desde la red**: solo se muestra un bloque de marcador con su texto alternativo. Es una decisión de privacidad: renderizar una imagen remota equivale a revelar al servidor de la otra parte que estás leyendo esa nota justo en ese momento.
La interfaz no impone límite de caracteres; el límite del backend es de 10 MiB por nota, algo que en el uso diario no se alcanza.
***
## Tags
Para etiquetar basta con escribir `#tag` en el texto de la nota. Al teclear `#` se abre una lista de sugerencias (8 como máximo): se navega con ↑↓ y se confirma con Enter.
Al guardar, los tags se extraen del texto y se muestran en la barra de tags al pie de la tarjeta; pulsando cualquiera de ellos se filtran todas las notas que lo llevan.
Los tags admiten jerarquías con `/`, por ejemplo `proyectos/cliente-a` o `lecturas/tecnologia`. Cada nota admite 50 tags como máximo, y cada tag tiene entre 1 y 64 caracteres.
**La interfaz no tiene un campo aparte para los tags: los tags solo se escriben en el texto de la nota.** Esto implica que, para quitar un tag, hay que borrar ese `#tag` del texto: el texto es la única fuente de verdad.
***
## Encontrar una nota
### Línea temporal
La vista de notas es un **flujo plano de tarjetas, sin agrupación por fecha**. El orden es siempre el mismo: **las antiguas arriba y las nuevas abajo**, igual que en un chat, de modo que la última siempre queda delante de tus ojos. Se cargan de 20 en 20 y, al desplazarte hacia arriba, puedes **Cargar anteriores**.
### Orden
El menú de ordenación de la parte superior tiene tres opciones:
| Orden | Qué significa |
| ------------------------- | ------------------------------------------------------------- |
| **Creación más reciente** | El predeterminado. Por fecha de creación, las nuevas al final |
| **Creación más antigua** | Justo al revés |
| **Edición reciente** | Por fecha de última modificación |
La ordenación es **por sesión**: no se guarda al cerrar la aplicación y la próxima vez vuelve a «Creación más reciente».
### Búsqueda
Pulsa la lupa de la parte superior o usa **⌘/Ctrl+F**.
La búsqueda no es una simple coincidencia de subcadenas: pasa por la búsqueda de texto completo de Linkly AI (mezcla de palabras clave y semántica cuando el índice semántico está construido, y solo palabras clave en caso contrario). Por eso al buscar «plan de lanzamiento» puede aparecer una nota que en realidad dice «calendario de publicación».
La búsqueda **devuelve 20 resultados como máximo y no tiene paginación**. Para acotar, filtra antes por un tag y busca después. La entrada tiene un antirrebote de unos 0,3 segundos: la consulta no se lanza hasta que dejas de escribir.
### Por qué no encuentro una nota recién escrita
Este es el punto que más confunde. Los tres bloques de la vista de notas se alimentan de **tres vías de datos distintas**, con tiempos distintos:
| Lo que estás mirando | De dónde salen los datos | Tras crear una nota |
| ------------------------------- | ------------------------------------------------ | ----------------------- |
| Línea temporal y filtro por tag | Lectura directa del sistema de archivos | **Visible al instante** |
| Resultados de la búsqueda | Dependen del índice | Con retardo |
| Sugerencias al escribir `#` | Dependen de la tabla de tags derivada del índice | Con retardo |
Así que es **normal** que una nota recién escrita se vea en la línea temporal pero no aparezca en la búsqueda ni en el autocompletado de `#`: en cuanto termine la indexación se arregla solo. Al revés, la línea temporal siempre está al día, porque ni siquiera consulta el índice.
***
## Dónde se guardan las notas
Todas las notas viven en `Notes/`, dentro de la raíz de tu espacio de documentos (por defecto `~/LinklyAI`), repartidas en carpetas por mes:
```
~/LinklyAI/Notes/
├── 2026-06/
│ └── Plan de Q3-3ea26713.md
└── 2026-07/
├── Ideas para-91805137.md
└── 2026-07-28-080741-ca478cef.md
```
Las carpetas de mes se calculan en **UTC**, así que una nota escrita a principio o a final de mes puede caer en un mes distinto del que marca tu zona horaria local.
### Regla de nombres de archivo
El nombre del archivo es `<10 primeros caracteres del texto>-<8 primeros dígitos del id de la nota>.md`:
* Los 10 primeros caracteres se cuentan como **caracteres Unicode** (un ideograma chino cuenta como uno)
* Los espacios en blanco consecutivos se colapsan en uno solo, y ese espacio sí cuenta dentro de los 10
* Los caracteres no válidos para el sistema de archivos (`/ \ : * ? " < > |`) se descartan y **no cuentan**
Un ejemplo real: en una nota cuya primera línea es `**Ideas para el sitio web**`, los `*` se descartan y no cuentan, así que se toman los 10 caracteres `Ideas para` y el archivo se llama **`Ideas para-91805137.md`**.
Si el texto son solo símbolos o espacios (no se puede extraer nada) o coincide justo con un nombre reservado de Windows (`CON`, `NUL` y similares), se recurre a un nombre con marca de tiempo: `YYYY-MM-DD-HHMMSS-.md`.
**El nombre se fija al crear la nota y editar el texto después no lo cambia.** Así la identidad del archivo es estable y ni el índice ni las referencias externas se rompen porque hayas corregido una errata.
### Formato del archivo
Cada archivo es Markdown estándar con un bloque de YAML front matter en la cabecera:
```markdown theme={null}
---
note_id: 91805137-c3f8-4bc9-8db4-e7e8d99409bc
created_at: 2026-07-28T08:02:21.095Z
updated_at: 2026-07-28T08:05:33.709Z
source: user
updated_by: user
tags:
- prueba
---
**Ideas para el sitio web**
Cosas que cerrar antes del lanzamiento:
- Textos de la portada
- Registro de cambios traducido a tres idiomas
- Envío a los sitios de descarga
#prueba
```
Qué significa cada campo:
| Campo | Descripción |
| --------------------------------- | ------------------------------------------------------------------------------------- |
| `note_id` | Identificador único de la nota (UUID); los 8 dígitos finales del nombre salen de aquí |
| `created_at` / `updated_at` | Fecha de creación / última modificación, en ISO 8601, con milisegundos y en UTC |
| `source` | Quién creó la nota: `user` (tú) o `agent` (la IA) |
| `agent` | Aparece solo cuando la escribe la IA, e indica qué agente fue |
| `updated_by` / `updated_by_agent` | Quién hizo la última modificación, con los mismos valores |
| `tags` | Lista de tags |
El orden de los campos es fijo. **Los campos desconocidos que añadas a mano se conservan tal cual**: la aplicación no los borra, así que puedes meter metadatos propios sin miedo.
Las notas escritas por la IA tienen este aspecto, y en la interfaz llevan una insignia `IA`:
```yaml theme={null}
source: agent
agent: linkly-chatbot # Chatbot integrado en la aplicación; cuando escribe un agente externo, es external-mcp
updated_by: agent
updated_by_agent: linkly-chatbot
```
***
## Abrir las notas en otro editor
En la parte superior hay un botón **Abrir carpeta de notas** que abre directamente la carpeta `Notes/` en el gestor de archivos del sistema.
Como son Markdown estándar, Obsidian, VS Code o Typora los leen y los editan sin más. El campo `tags:` es precisamente el que Obsidian reconoce de forma nativa: si abres `Notes/` como Vault, su panel de tags funciona tal cual.
Cuando hay cambios externos, la aplicación los detecta en su siguiente exploración. Si resulta que **estabas editando esa misma nota** dentro de la aplicación, aparece un aviso de conflicto para que elijas entre **Recargar** o **Copiar mi texto**: **nunca se sobrescribe en silencio** ninguno de los dos lados.
También puedes renombrar los archivos libremente: la aplicación no revierte el cambio.
Hay dos operaciones que hacen «desaparecer» notas; conviene evitarlas:
1. **La línea temporal solo explora los `.md` que están en la estructura de dos niveles `Notes/YYYY-MM/`.** Los archivos que dejes en la raíz de `Notes/` o en otras subcarpetas como `Notes/archive/` **no aparecerán en la línea temporal** (aunque sí se indexan a texto completo y se pueden buscar).
2. **Si borras la cabecera YAML**, esa nota desaparece de la línea temporal: el archivo sigue en el disco y se puede buscar, pero la aplicación deja de considerarlo una nota.
***
## Deja que la IA tome notas por ti
Tu asistente de IA puede leer y escribir notas. De ello se encargan dos herramientas, expuestas tanto por el MCP local como, en remoto, por la pasarela en la nube:
| Capacidad | Herramienta MCP | Comando de la CLI |
| -------------- | --------------- | --------------------------- |
| Escribir notas | `note_save` | `linkly note-save` |
| Listar notas | `list` | `linkly list --scope notes` |
Los parámetros completos están en [Usar la CLI](/docs/es/use-cli). Para configurar el MCP, consulta [Conectar tus herramientas de IA](/docs/es/use-mcp).
Basta con darle instrucciones en lenguaje natural:
«Guarda esta conclusión como una nota y ponle los tags producto y pendiente»
«Lee el material sobre attention de mi biblioteca ml-papers y resume los puntos clave en una nota»
«Lista mis notas con el tag ops»
Conviene conocer algunas diferencias de esta vía:
* **La edición exige un número de versión para el control de concurrencia.** Cuando la IA edita una nota tiene que enviar la `version` que leyó; si la nota ha cambiado entretanto, la escritura se rechaza (`NOTE_VERSION_CONFLICT`) en lugar de sobrescribir a ciegas.
* **El formato del texto que escribe la IA está limitado**: solo se permiten párrafos, negrita, tachado, listas ordenadas y sin ordenar, y texto plano, es decir, lo mismo que ofrece la barra de herramientas. Los encabezados, la cursiva, los bloques de código, los enlaces, las imágenes y las tablas se rechazan. **Cuando escribes tú a mano en la interfaz no tienes esta limitación.**
* **El MCP no tiene herramienta de borrado.** Las notas solo se eliminan desde la interfaz de la aplicación.
* **El acceso remoto sigue acabando en tu propio ordenador.** Las dos herramientas funcionan también a través de la pasarela en la nube (`linkly --remote`, o el conector en la nube de tu cliente de IA), pero la pasarela se limita a reenviar a tu aplicación de escritorio: las notas nunca se guardan en la nube. Por eso trabajar con las notas en remoto exige que ese ordenador esté en línea y un plan Pro, y cuando no se puede alcanzar no hay ninguna copia en la nube a la que recurrir.
* **Las reglas de tags son distintas**: por esta vía **no se extraen los `#tag` del texto**, solo se tienen en cuenta los tags que se pasan explícitamente como parámetro; y al editar, los tags se **reemplazan por completo**, así que los que no se envíen se pierden.
Si después de que la IA escriba una nota a través del MCP no la ves aparecer de inmediato en la interfaz, cambia a la vista de conversación y vuelve a las notas.
***
## Preguntas frecuentes
Hoy por hoy las notas **no tienen sincronización propia en la nube**: se guardan como archivos locales dentro de la carpeta de tu espacio de documentos.
Ten en cuenta un detalle: si has metido la carpeta `Notes/` dentro de alguna biblioteca y esa biblioteca está vinculada y se envía a una [biblioteca en la nube](/docs/es/use-cloud-library), las notas se suben igual que cualquier otro documento Markdown. Si quieres que se queden estrictamente en local, no incluyas `Notes/` en las bibliotecas que envías.
Ese atajo **solo funciona cuando la ventana del Chatbot tiene el foco**; no es un atajo global. Haz clic primero en la ventana del Chatbot y vuelve a pulsarlo. El único atajo realmente global es ⌘⇧L / Ctrl+Shift+L, que abre el lanzador de búsqueda.
No se ha perdido. La línea temporal lee el sistema de archivos directamente, por eso la ves al instante; la búsqueda de texto completo pasa por el índice y va con retardo. En cuanto termine la indexación la encontrarás. Lo mismo ocurre con los tags nuevos: tardan un poco en aparecer entre las sugerencias de `#`.
Ninguna de esas opciones existe todavía. Fijar, marcar como favorita y archivar no están entre las funciones actuales; exportar no hace falta, porque la nota ya es un archivo `.md` en tu disco y basta con copiarlo. Si necesitas archivar, puedes mover el archivo a otra carpeta desde un editor externo, pero recuerda que entonces desaparece de la línea temporal (más detalles en [Abrir las notas en otro editor](#abrir-las-notas-en-otro-editor)).
La vía MCP / CLI **no extrae los `#tag` del texto** y escribe solo los tags pasados
explícitamente como parámetro, de modo que los tags quedan en el YAML pero no tienen su `#tag`
correspondiente en el texto; y como la interfaz cambia los tags editando el texto, no hay nada que cambiar.
Hay dos formas de resolverlo: editar el campo `tags:` del archivo directamente con un editor externo, o añadir los `#tag` correspondientes en el texto y guardar otra vez desde la interfaz.
No. Al eliminar se borra el archivo del disco directamente, sin pasar por la papelera del sistema y sin deshacer dentro de la aplicación. Piénsalo antes de borrar, o haz una copia con un editor externo.
Sí. Las notas son archivos Markdown corrientes dentro de `~/LinklyAI` y se exploran, indexan y recuperan igual que el resto de documentos, así que también las encontrarás desde el [lanzador de búsqueda](/docs/es/use-launcher) y tu asistente de IA las alcanza con `search`.
***
## Lecturas adicionales
* [Usar el lanzador](/docs/es/use-launcher) — búsqueda global, en la que también entran las notas
* [Usar la CLI](/docs/es/use-cli) — todos los parámetros de `note-save` y `list --scope notes`
* [Conectar tus herramientas de IA](/docs/es/use-mcp) — dejar que un asistente externo lea y escriba tus notas
* [Introducción a las herramientas](/docs/es/tools-intro) — descripción completa de las herramientas MCP
* [Chatear con la IA](/docs/es/use-chatbot) — qué más se puede hacer en la ventana donde viven las notas
* [Espacio de Linkly AI](/docs/es/linkly-space) — la carpeta que contiene `Notes/` y cómo cambiarla de sitio