Notes: espacio de trabajo Markdown persistente

El modulo Notes proporciona un editor de markdown integrado para almacenar prompts tecnicos, planes de despliegue y especificaciones de trabajo sin salir del panel de DevSpeak. Las notas son privadas para tu cuenta y persisten entre sesiones.

Resumen de la funcionalidad

Se puede acceder a Notes desde el Navigation Panel bajo la entrada NOTES. Se muestra como un diseño de ancho completo con dos paneles:

Cada nota almacena un titulo (extraido del primer encabezado # o con el valor predeterminado "Untitled note"), el contenido markdown sin procesar y marcas temporales de creacion y actualizacion que impulsan el mecanismo de guardado automatico.

Estado vacio y onboarding

Cuando no existen notas, o no hay ninguna nota seleccionada, el panel derecho muestra un prompt de onboarding:

> Inicia una nota

> Mantén prompts tecnicos, planes de despliegue y especificaciones de trabajo en un solo lugar sin salir de DevSpeak.

Un call-to-action + CREATE NOTE crea una nota nueva y abre el editor en modo Write con un buffer de contenido vacio.

Modos del editor

La barra de herramientas del editor expone tres modos de vista mutuamente excluyentes, alternables mediante botones segmentados:

Modo Write

La superficie de edicion predeterminada. Renderiza un </code> de ancho completo (o una region contenteditable) con una barra de herramientas de formato que admite:</p><p>| Accion de la barra | Atajo Markdown | Descripcion |</p> <p>| :----------------- | :------------- | :-------------------------------------------------- |</p> <p>| Encabezado | <code>## </code> | Alterna un marcador de encabezado en la linea |</p> <p>| <strong>Negrita</strong> | <code><strong>text</strong></code> | Envuelve la seleccion con dobles asteriscos |</p> <p>| _Cursiva_ | <code>*text*</code> | Envuelve la seleccion con asteriscos simples |</p> <p>| Tachado | <code>~~text~~</code> | Tachado GFM |</p> <p>| Cita en bloque | <code>> </code> | Anteponer al inicio de la linea el marcador de cita |</p> <p>| Lista ordenada | <code>1. </code> | Inserta un elemento de lista numerada |</p> <p>| Lista no ordenada | <code>- </code> | Inserta un elemento de lista con viñeta |</p> <p>| Codigo en linea | `<code> </code>code<code> </code><code> | Envuelve la seleccion entre backticks |</p> <p>| Bloque de codigo | </code> ``<code> </code> | Inserta un bloque de codigo delimitado |</p> <p>| Tabla | <code>\| col \|</code> | Inserta un esqueleto de tabla GFM |</p> <p>| Enlace | <code>[text](url)</code> | Inserta un hipervinculo |</p><p>La barra de estado situada debajo de la barra de herramientas muestra el estado actual de guardado, uno de <code>SAVED</code>, <code>SYNCING</code> o <code>UNSAVED</code>, impulsado por un guardado automatico con debounce que persiste tus cambios tras un breve intervalo de inactividad.<h2>Atajos de teclado</h2></p><p>Los atajos funcionan mientras el editor tiene el foco. En Windows y Linux, pulsa <code>Ctrl</code> donde se indique <code>⌘</code>. Pulsa <code>⌘/</code> en el editor web, o haz clic en el icono de teclado de la barra de herramientas, para abrir la referencia de atajos sin salir de la nota.</p><p>| Atajo | Accion | Web | App macOS |</p> <p>| :---- | :---------------------- | :-: | :-------: |</p> <p>| <code>⌘B</code> | Negrita | ✓ | ✓ |</p> <p>| <code>⌘I</code> | Cursiva | ✓ | ✓ |</p> <p>| <code>⌘⇧K</code> | Insertar enlace | ✓ | ✓ |</p> <p>| <code>⌘E</code> | Codigo en linea | ✓ | — |</p> <p>| <code>⌘⇧X</code> | Tachado | ✓ | — |</p> <p>| <code>⌘⇧.</code> | Cita | ✓ | — |</p> <p>| <code>⌘Z</code> | Deshacer | ✓ | ✓ |</p> <p>| <code>⌘⇧Z</code> | Rehacer | ✓ | ✓ |</p> <p>| <code>⌘A</code> | Seleccionar todo | ✓ | ✓ |</p> <p>| <code>⌘F</code> | Buscar en la nota | ✓ | ✓ |</p> <p>| <code>⌘S</code> | Guardar ahora | ✓ | ✓ |</p> <p>| <code>⌘/</code> | Mostrar esta referencia | ✓ | — |</p><p><code>⌘B</code>, <code>⌘I</code> y <code>⌘⇧K</code> estan enlazados de forma identica en ambas superficies, por lo que la memoria muscular se transfiere. El resto de los comandos de formato estan disponibles desde la barra de herramientas en todas las superficies.</p><p><code>⌘K</code> <strong>no</strong> esta enlazado en el editor de forma deliberada: abre la paleta de comandos de DevSpeak, por lo que la insercion de enlaces usa <code>⌘⇧K</code>.<h3>Modo Split</h3></p><p>Renderiza el editor y una vista previa Markdown en vivo lado a lado en un diseño horizontal 50/50. Mientras escribes en el panel izquierdo, el panel derecho vuelve a renderizar el markdown analizado en tiempo real.</p><p><h3>Modo Preview</h3></p><p>Oculta el editor sin procesar y renderiza la salida Markdown completa en modo de solo lectura. Es util para la revision final antes de exportar o para leer especificaciones extensas.</p><p><h2>Persistencia y guardado automatico</h2></p><p>Todo el contenido de la nota se guarda automaticamente en la nube y esta disponible desde cualquier dispositivo en el que inicies sesion.</p><p>1. <strong>Creacion</strong> — <code>+ NEW</code> o <code>+ CREATE NOTE</code> inicializa una nota en blanco con el titulo predeterminado "Untitled note".</p> <p>2. <strong>Guardado automatico</strong> — Los cambios se guardan automaticamente despues de ~1 segundo de inactividad. La barra de estado transita por <code>UNSAVED → SYNCING → SAVED</code>.</p> <p>3. <strong>Guardado manual</strong> — El boton <strong>SAVE NOW</strong> fuerza un guardado inmediato, omitiendo el temporizador de guardado automatico.</p> <p>4. <strong>Resolucion de conflictos</strong> — Si editas la misma nota en varios dispositivos, prevalece el guardado mas reciente.<h2>Gestion de notas</h2><h3>Busqueda</h3></p><p>La barra de busqueda del panel izquierdo filtra la lista de notas en el cliente al hacer coincidir la consulta tanto con el titulo de la nota como con el cuerpo del contenido. El filtro no distingue entre mayusculas y minusculas y se aplica al instante cuando cambia la entrada.<h3>Save Now</h3></p><p>Fuerza un guardado inmediato del buffer actual del editor, util cuando quieres garantizar que tus cambios se hayan persistido antes de salir.<h3>Export</h3></p><p>El boton <strong>EXPORT</strong> serializa el contenido markdown sin procesar de la nota en un archivo <code>.md</code> y activa una descarga del navegador mediante una URL <code>Blob</code> construida dinamicamente. El nombre de archivo predeterminado se deriva del titulo de la nota, saneado para la compatibilidad con el sistema de archivos (por ejemplo, <code>Prompt-Refactoring-Refinement-Log.md</code>).</p><p><h3>Delete</h3></p><p>Elimina la nota de forma permanente. Se muestra un dialogo de confirmacion para evitar la perdida accidental de datos. El dialogo advierte: _"This action cannot be undone. The note and all its content will be permanently removed."_<h2>Integracion con la barra lateral</h2></p><p>La vista Notes esta registrada como un elemento de navegacion de primera clase en la barra lateral del Dashboard, situada entre <strong>PROJECTS</strong> y <strong>HISTORY</strong>:</p><p>``<code></p> <p>TRANSLATE TEXT</p> <p>TRANSLATE FILES</p> <p>PROJECTS</p> <p>NOTES ← current</p> <p>HISTORY</p> <p>API KEYS</p> <p></code>`<code></p><p>El estado activo se indica mediante el color de acento principal en la etiqueta y el icono de la barra lateral.<h2>Limites y especificaciones</h2></p><p>| Aspecto | Detalle |</p> <p>| :------------------------- | :------------------------------------------------------------------------------ |</p> <p>| <strong>Tamano maximo</strong> | 200 KB por nota (aparece una advertencia al acercarte al limite) |</p> <p>| <strong>Retraso de auto-save</strong> | ~1 segundo de inactividad |</p> <p>| <strong>Privacidad</strong> | Las notas son privadas: solo son visibles para tu cuenta |</p> <p>| <strong>Markdown</strong> | Compatibilidad completa con GFM, incluidas tablas, bloques de codigo e imagenes |</p> <p>| <strong>Formato de exportacion</strong> | Descarga de archivo </code>.md<code> (Markdown) |<h2>Buenas practicas</h2><li><strong>Usa encabezados para dar estructura</strong> — Las notas que empiezan con un </code># Heading<code> usan automaticamente ese encabezado como titulo visible en la lista lateral.</li></p> <li><strong>Aprovecha el modo Split para especificaciones extensas</strong> — Escribir documentos complejos se beneficia de la vista previa en tiempo real para detectar problemas de formato desde el principio.</li> <li><strong>Exporta antes de cambios importantes</strong> — Usa la funcionalidad Export para crear una copia de seguridad local antes de reestructurar una nota grande.</li> <li><strong>Mantente dentro del limite de 200 KB</strong> — Para documentos muy grandes, considera dividir el contenido en varias notas o usar la funcion Document Translation con archivos </code>.md` cargados.</li> </body> </html>