--- id: "canvas.notas.visao-geral" titulo: "Notas en el Canvas" resumo: "Usa tarjetas de nota como memoria del proyecto: dónde quedan los archivos, cómo editar y cómo buscar dentro de una nota." idioma: "es" tipo: "guia" categoria: "telas" aplicavelDesde: "0.0.16" capabilities: ["note.cards.create", "note.cards.edit", "note.cards.find", "note.cards.colors", "note.files.location"] estadoEditorial: "aprovado" nivelEvidencia: "artefato-distribuido" refFonte: "27574c339b58316408f6be2d62169d59041d07bf" revisaoFonte: "2026-09-24" revisor: "mantenedor (v1, 2026-10-03)" rota: "/docs/es/canvas/notas/visao-geral/" fonte: "pt-br/canvas/notas/visao-geral.md" caminhoPublico: "docs/publica/es/canvas/notas/visao-geral.md" hashFonte: "sha256:83a99a861ff0206366df451aeb82561a66b89f13f47bf4121a7a19e34be9cd14" hashDestaPagina: "sha256:4b8d323fd3f685eb3836d48f56101efe79c4ddf9defb1c6cfe622a31c6977119" traducaoAssistidaPorIA: true traducaoDesatualizada: false corpoRetido: false --- Una **tarjeta de nota** es texto en **Markdown** guardado en un archivo `.md`. Sirve para dos cosas a la vez: es tu memoria del proyecto en el tablero, y es el material que los agentes pueden leer y escribir. Porque es un archivo de verdad, la nota sobrevive a la app: cerrar y reabrir no pierde texto, y cualquier herramienta fuera de Elyra puede leer el mismo archivo. ## Dónde quedan los archivos Las notas **no viven dentro del proyecto**. Están en una carpeta gestionada por la app, fuera del repositorio, con una ruta por workspace con el formato: ``` ~/.elyra/projetos///notas/ ``` Los nombres de las carpetas de proyecto y de workspace llevan un sufijo identificador, así que la ruta exacta no es predecible de memoria. **La ruta absoluta real es lo que devuelve la línea de comandos en el campo `noteFilePath`** al listar o leer una nota — usa ese valor cuando necesites el archivo en el disco. Esa decisión tiene un motivo práctico: cuando las notas estaban dentro del repositorio, una limpieza de archivos no versionados (`git clean -xdf`) se llevaba las notas consigo. Fuera del proyecto, eso no pasa. Dos consecuencias: - **Workspace remoto por SSH es la excepción.** En ese caso la carpeta de notas queda **dentro del checkout**, en el host remoto. Eso está declarado como temporal, hasta que exista resolución de carpeta personal remota — no cuentes con paridad entre local y SSH para notas. - **El identificador guardado de la nota no es una dirección.** La tarjeta guarda una identidad con el formato `.elyra/notas/.md`, que no es dónde está el archivo de hecho. Solo el `noteFilePath` es la ruta real. > **Notas antiguas.** Las notas que estaban dentro del proyecto, en las dos carpetas antiguas, se **mueven** a la carpeta gestionada. La migración corre en el arranque, **no sobrescribe** un archivo ya existente en el destino (un nombre ocupado recibe un sufijo) y, si falla, **deja el archivo donde está** para intentarlo de nuevo en el próximo arranque. Es **best-effort**: un archivo puede quedarse atrás en un fallo. ## Crear una nota Desde la barra de arriba: **Añadir Nota › Nota**. Con el clic derecho en el fondo: **"Agregar aquí" › Nota**. Los dos crean la tarjeta y el archivo, y el editor de la nota recién creada **recibe el foco automáticamente** — puedes empezar a escribir. Por la línea de comandos, la nota nace ya con contenido: ``` elyra canvas create note --title "Resumen de la reunión" --content "Primera línea" elyra canvas create note --content-file ./texto.md ``` - `--content` escribe el texto en el archivo al nacer. - `--content-file` lee de un archivo, o de `-` para leer de la entrada estándar. Es el camino para **texto con varias líneas** — las comillas del shell estropean los saltos de línea. - Con `--title`, el archivo nace con ese nombre y **el nombre queda fijo**. - Sin `--title`, **el nombre sigue la primera línea del contenido**. Mientras no escribas un nombre, la tarjeta muestra "automático"; escribir un nombre lo fija. El nombre del archivo se sanea: los caracteres inválidos se vuelven `-`, los nombres reservados del sistema reciben un prefijo y hay un techo de longitud. No tienes que ocuparte de eso. ## Editar El cuerpo de la tarjeta es un **editor enriquecido** de Markdown, con barra de herramientas y un campo de escritura con la pista "Escribe tu nota…". - **La grabación se aplaza unos 600 ms** después de la última tecla. Por eso, parar de escribir un instante y mirar el archivo en el disco es la forma de confirmar que se guardó. - **Las ediciones hechas fuera de la app aparecen en la tarjeta.** La app observa el archivo y refleja lo que cambió. - **Un fallo de lectura bloquea el editor** en vez de vaciar el archivo. Si la nota no se puede leer, la tarjeta avisa y ofrece **Intentar de nuevo** — no se borró nada, y debes comprobar si el archivo se movió o se borró fuera de Elyra. - **Cerrar durante una edición pendiente** descarga la grabación aplazada antes de borrar, para no recrear un archivo que debería salir. ### Herramientas de la nota La barra de la nota trae **negrita**, **cursiva**, **tachado**, **lista** y **lista numerada**, además de la paleta de colores. ### Color de fondo La paleta ofrece **Predeterminado**, **Amarillo**, **Verde**, **Azul**, **Rosa**, **Morado** y **Gris**. Elegir **Predeterminado** limpia el color. El color es una propiedad de la **tarjeta**, no del texto: **no altera el archivo `.md`** y, por lo tanto, no viaja con la nota si abres el archivo en otro lugar. ## Buscar dentro de la nota La barra de búsqueda **"Buscar en la nota"** destaca y navega por los resultados dentro del cuerpo de la tarjeta, con **Anterior**, **Siguiente** y un contador con el formato `actual de total`, además de **"Sin resultados"** cuando no hay coincidencia. **Esc** cierra la búsqueda. La búsqueda es solo de interfaz y no altera el archivo ni el proceso. ## Escribir en una nota por la línea de comandos Un agente puede leer y escribir la nota sin abrir el editor: ``` elyra canvas note read [--workspace ] [--json] elyra canvas note write (--content | --content-file ) [--append] [--workspace ] [--json] ``` - `` acepta el **id de la tarjeta**, el **título de la tarjeta** o el **nombre de la nota**. - **Sin `--append`, el contenido sustituye el archivo entero.** Con `--append`, el texto va al final, después de un salto de línea. - Sin `--json`, la lectura imprime **el contenido puro** de la nota. > **Escritura concurrente con el editor.** El comando es el **escritor más nuevo**: el texto que todavía estaba en la grabación aplazada del editor se descarta a propósito, y la tarjeta en pantalla toma el contenido nuevo por el observador de archivo. Antes de escribir en una nota que está abierta, guarda lo que escribiste. > **La app tiene que estar abierta.** Sin ventana de la aplicación, esas operaciones se rechazan en vez de grabar en un estado que nadie ve. ## Límites - **Workspace remoto por SSH.** Las notas quedan **dentro del checkout** en el host remoto, y la migración a la carpeta gestionada **no corre** en ese caso. No hay paridad entre local y SSH para notas. - **Una nota cuyo archivo desapareció no monta editor ni graba.** Es a propósito: evita que el guardado automático recree el archivo vacío por encima de lo que existía. La tarjeta muestra el error, preserva el texto que ya conocía y ofrece **Intentar de nuevo**. - **Dos tarjetas con el mismo nombre vuelven ambiguo el selector.** La línea de comandos te pide usar el **id** en ese caso — el nombre es comodidad, no dirección única. - **No hay un límite de tamaño documentado para la nota.** Una nota grande se lee y se graba entera; no cuentes con truncamiento ni con aviso de "demasiado grande".