--- title: "File-first: los archivos son la fuente de verdad" description: "Las notas son archivos Markdown planos en tu disco: la fuente de verdad. El índice, el grafo y la búsqueda son artefactos derivados reconstruibles." --- # File-first: los archivos son la fuente de verdad La unidad de datos en Notarium es un archivo Markdown plano en tu disco. No una fila en la base de datos de otro, ni un bloque dentro de un almacén propietario, sino un archivo que se abre con cualquier editor y que sigue estando completo sin Notarium. Este es el principio file-first, y de él se desprende todo lo demás. ## Qué es "verdad" y qué es derivado La fuente de verdad son los propios archivos `.md`. Todo lo que se puede calcular a partir de su contenido es derivado y reconstruible: - **derivado** (se rehace desde cero con un reescaneo): el índice de búsqueda, el grafo de `[[wikilinks]]`, el árbol, los fragmentos. Borrar el índice no es motivo de preocupación: el motor reindexa los archivos en el siguiente arranque; - **no derivable** (vive en una base de datos de metadatos aparte): el historial de versiones, los usuarios, la membresía y los accesos. Es justo lo que no se puede reconstruir a partir del texto de los archivos, y por eso se agrupa en un único lugar claramente separado. La identidad, en cambio, está anclada en los propios archivos: el `notarium-id` de una nota vive en su frontmatter, y los identificadores de espacio y de proyecto, en archivos marcadores (`.notariummeta`). Por eso las tablas de espacios y proyectos de la base de datos de metadatos son una caché reconstruible mediante escaneo, y no el único lugar donde reside la identidad: esta sobrevive incluso si mueves la carpeta fuera de Notarium. > [!note] Por qué esto importa > Perder el índice es inofensivo: simplemente se vuelve a construir. Los archivos no se tocan en ningún momento: la escritura es atómica (se escribe en un archivo temporal y después se renombra), y las ediciones externas (git, otro editor) se tratan como un modo de trabajo normal, no como un error. Una edición externa se detecta aunque el archivo conserve el tamaño y la fecha de modificación anteriores, que es exactamente lo que ocurre tras un `git checkout`, una sincronización o una restauración desde un archivo de copia de seguridad. Notarium no se fía de los metadatos del archivo: la última palabra la tiene el contenido, así que todo lo derivado (el listado, la búsqueda, el grafo) acaba coincidiendo con lo que hay realmente en disco en lugar de quedarse atascado en una versión obsoleta. ## Un archivo-nota, no un bloque El límite está trazado a propósito: la unidad de datos es el archivo-nota entero, no un párrafo ni un bloque dentro de él. Notarium no introduce entidades separadas más pequeñas que el archivo (la nota completa sigue siendo la unidad mínima); es justo aquí donde las aplicaciones de notas basadas en archivos suelen pasarse a una base de datos como fuente de verdad y pierden la portabilidad. Una nota sigue siendo un archivo, y la estructura interna es simplemente Markdown. Las notas se renderizan como GitHub Flavored Markdown; los campos de metadatos se guardan en el frontmatter, al principio del archivo. ## La identidad sobrevive al traslado Cada nota tiene un identificador interno estable, `notarium-id`: una clave URL-safe de 12 caracteres en el frontmatter del archivo: ```md --- notarium-id: aB3kR7xQ_2mv title: Mi nota --- El texto de la nota, en Markdown plano. ``` La identidad vive **en el propio archivo**, no solo en una base de datos. Por eso ni renombrar la nota, ni moverla entre carpetas, ni siquiera sacarla de Notarium dejan huérfanos su historial de versiones ni sus conexiones: el registro y los enlaces están vinculados al `notarium-id`, no a la ruta. El nombre del archivo es derivado (kebab-case por transliteración, `slug(title).md`) y no constituye identidad. ## Sin lock-in Puedes llevarte la carpeta de archivos e irte en cualquier momento: sin Notarium las notas siguen siendo legibles y completas. No hace falta exportar como operación aparte, porque en realidad nunca estás "dentro": tus datos siempre están como archivos normales en tu disco. `git` puede ser la fuente de verdad: versiona la carpeta, sincronízala y lee el historial con las herramientas de siempre. Esta es también la base de la privacidad en Notarium: no se apoya en el cifrado de extremo a extremo (el servidor inteligente ve el contenido a propósito, porque de lo contrario no habría búsqueda, ni semántica, ni agentes), sino en que el servidor y los archivos los tienes tú. Más en [Espacios y proyectos](/docs/concepts/spaces-and-projects/) y [Modelo de acceso](/docs/concepts/access-model/).