NotariumDocumentación
Versión de la documentación: latest
ES

Tu primera nota

Superaste la instalación y ya estás en el editor. Ahora vamos a crear tu primera nota y a ver qué ocurre en disco: en Notarium una nota no es una fila en la base de datos de otro, sino un archivo .md normal en tu propia carpeta. Todo lo que escribas queda ahí como texto Markdown plano, que se abre en cualquier editor y sobrevive al propio Notarium.

El árbol de archivos a la izquierda

A la izquierda está el árbol de carpetas y notas de tu espacio. Refleja uno a uno la estructura de archivos bajo /data/spaces: una carpeta del árbol es una carpeta en disco, una nota es un archivo dentro de ella. El árbol está pensado para decenas de miles de entradas y carga el contenido de cada carpeta a medida que la despliegas.

Aquí mismo viven las operaciones principales: crear una nota o carpeta, renombrar sobre la marcha, arrastrarla a otra carpeta. Un detalle importante: cambiar la carpeta o el título de una nota existente mueve el archivo en sí en lugar de generar un duplicado.

Las carpetas vacías son de primera clase

Una carpeta no desaparece cuando le quitas su última nota. Puedes preparar tu estructura de antemano.

El título es la primera línea

Notarium no tiene un campo «Título» aparte. El título de una nota es su # H1 inicial, es decir, la primera línea del documento. Lo editas ahí mismo, dentro del texto, igual que todo lo demás. Una nota nueva se abre ya en una línea # con el cursor situado sobre el título: solo tienes que empezar a escribir.

Si no hay un # H1 inicial, el título pasa a ser la primera línea de prosa no vacía, así una anotación rápida no se convierte en una base llena de «Sin título». Pero si el documento arranca con un bloque estructural (código, lista, cita, tabla, un encabezado de nivel H2 o inferior) y nunca se llega a fijar un título, la nota no se guardará sin título: de ese modo la primera línea de código no se filtra en silencio al título.

El título enlaza a la vez el nombre del archivo, la búsqueda, el grafo y el historial; por eso hay una sola superficie de edición en lugar de un "campo + cuerpo" que se van separando.

Modos de escritura

Notarium siempre edita Markdown en crudo: la única fuente de verdad. El aspecto que tiene ese texto mientras lo editas lo define el modo de escritura (una preferencia personal en Settings → Appearance):

  • Source (por defecto) — Markdown en crudo tal cual: fuente monoespaciada, resaltado de sintaxis. Los marcadores como #, **, []() se muestran como texto normal. Para quienes trabajan con el origen directamente.
  • WYSIWYM — "lo que ves es lo que quieres decir": el texto va estilizado (encabezados más grandes, la negrita en negrita, las citas con fondo), pero los marcadores de Markdown siguen en pantalla, atenuados. El largo de la línea no cambia, así que el cursor no "salta".

Ambos modos editan exactamente la misma línea y la guardan byte a byte igual: cambiar de modo no altera el contenido del archivo.

Al margen de los modos está el botón Vista previa (Preview) en la barra superior: en cualquier momento muestra el render HTML final de la nota, sin guardar. Para textos largos están los ayudantes de escritura Focus (atenúa todo salvo la frase/línea/párrafo activo) y Typewriter (mantiene centrada la línea donde está el cursor).

Enlaces entre notas

Dentro del texto funcionan los wiki-links: [[título de la nota]] o [[título|etiqueta]]. Un clic te lleva a esa nota dentro de la aplicación. Si no existe ninguna nota con ese título, Notarium ofrece crearla, y hasta entonces queda colgando en el grafo de enlaces como un nodo fantasma hueco.

Guardar y qué acaba en disco

Se guarda con Ctrl/Cmd+Enter. A disco va Markdown limpio, sin reescapado ni renormalización: exactamente lo que escribiste. Notarium deriva el nombre del archivo a partir del título (kebab-case, transliterando el cirílico), de modo que el archivo también se lee bien fuera de la aplicación.

Al principio del archivo se coloca un pequeño bloque de frontmatter y, dentro, la clave notarium-id: un identificador estable de 12 caracteres para la nota. Es él, y no la ruta ni el nombre del archivo, la identidad verdadera de la nota: renombrar y mover entre carpetas no rompe los enlaces ni pierde el historial de versiones, porque el registro se lleva por notarium-id.

Editar desde fuera es un modo normal

¿Editaste el archivo .md en otro editor o lo trajiste desde git? Notarium recoge los cambios en su próximo escaneo. Los archivos siguen siendo la fuente de verdad; el índice simplemente se reconstruye para ajustarse a ellos.

Cada guardado va al historial de revisiones: una instantánea completa del estado de la nota con su procedencia — quién la editó y cómo (tú, un editor externo o un agente). Cualquier versión se puede ver, comparar y revertir.

Siguiente