Referencia de bases de datos (.base)

Última actualización: 2026-11-03

Esta página enumera todo lo que puede contener un archivo .base y lo que Plainva hace con cada parte: cada clave de nivel superior, cada forma de filtro, cada tipo de vista con sus opciones, los resúmenes, el orden, los límites, qué ocurre con las claves que Plainva no conoce y en qué se comporta Plainva de forma distinta a Obsidian Bases. Describe lo que el código de Plainva lee, evalúa y escribe hoy — no la documentación de Obsidian.

Para el uso cotidiano, lee primero Bases de datos (.base). Las reglas que debe respetar una herramienta cuando escribe directamente en los archivos del vault, y el ejemplo completo de relaciones, están en la Referencia del formato de archivo.

De un vistazo

Parte del archivoQué hace Plainva
filtersLee y aplica las fuentes (carpeta, etiqueta) y las condiciones que se enumeran en Filtros
viewsLee los ocho tipos de vista, su orden, orden de clasificación, filtros y resúmenes
propertiesLee el esquema de columnas, el nombre visible y el bloque plainva de Plainva
summaries (vista)Calcula los catorce resúmenes incorporados
formulasLas conserva en el archivo, no las calcula
summaries (nivel superior)Conserva las fórmulas de resumen personalizadas, no las calcula
thisAún no es compatible
Otras clavesLas conserva en el archivo (ver Claves que Plainva no conoce)

Claves de nivel superior

Un archivo .base es YAML con estas claves de nivel superior. Todas son opcionales; un archivo sin views se abre con una tabla.

ClaveContenidoEn Plainva
filtersQué notas pertenecen a la base de datos (fuentes)Se lee y se aplica
propertiesUna entrada por columna, con el id de la propiedad como claveSe lee; las adiciones de Plainva viven en su bloque plainva
viewsLa lista de vistasSe lee; cada vista necesita un name
formulasFórmulas de Obsidian, name: expressionSe conservan sin cambios, no se calculan
summariesFórmulas de resumen personalizadas de ObsidianSe conservan sin cambios, no se calculan

Plainva nunca escribe otra clave de nivel superior: Obsidian se niega a abrir un .base con una clave que no conoce. Una clave columns: de nivel superior escrita por versiones muy antiguas de Plainva se sigue leyendo y se traslada a properties la próxima vez que se guarda el archivo.

Propiedades (properties)

Ids de propiedad

Un id de propiedad da nombre a una columna. Existen tres tipos:

IdSignificaEjemplo
note.<key>Una clave del frontmatter de las notasnote.status
file.<field>Un dato sobre el archivo (ver Campos de archivo)file.mtime
formula.<name>Una fórmula de Obsidian de formulasformula.price_per_unit

Las claves de properties, el order de una vista y sort[].property usan estos ids. Dentro de una expresión de filtro y dentro de un bloque plainva, una clave del frontmatter se escribe sin prefijo (status); una expresión de filtro entiende también note.status.

Cuando una nota escribe una clave con otra capitalización que la columna (Due frente a la columna due), Plainva sigue mostrando el valor en esa columna y escribe los cambios con la grafía propia de la nota.

Nombre visible

properties.<id>.displayName es la etiqueta de columna de Obsidian. Plainva la muestra como encabezado de la columna y la conserva. Sin ella, una clave del frontmatter se muestra con la primera letra en mayúscula (solo en pantalla); los campos de archivo tienen sus propios nombres, por ejemplo Nombre, Modificado, Tamaño, Ruta, Lista de tareas y Día del nombre del archivo.

El bloque plainva de una columna

Todo lo que Plainva añade a una columna vive bajo properties.<id>.plainva. Obsidian lo ignora.

ClaveValorSignificado
inputun tipo de campo (lista más abajo)El tipo de campo de la columna
ratingMaxnúmero, de 1 a 10Cuántas marcas tiene una valoración (por defecto 5)
ratingGlyphun carácterLa marca que dibuja una valoración (por defecto un punto)
optionslista de opcionesValores fijos para selección, estado y selección múltiple
relationBaseruta .base relativa al vaultLa base de datos a la que apunta una relación
relationLimitoneUna relación contiene exactamente un enlace; si falta, no hay límite
reverseOf{ base, property }Una columna calculada de relación inversa
rollup{ through, of, fn, where }Una columna calculada de agregación (ver Agregaciones)
previousKeyslista de hasta 8 nombres anterioresPermite que los comentarios vuelvan a encontrar una columna renombrada

Tipos de campo (input)

text, number, rating, checkbox, date, datetime, select, status, multiselect, list, tags, url, email, phone, relation.

También se leen dos grafías antiguas: multi-select como multiselect y link como relation. Una columna sin input — o con un valor que no está en esta lista — obtiene su tipo de los valores de las notas: true/false es una casilla de verificación, un número un número, una lista de [[links]] una relación, 2026-07-03 una fecha, una dirección web una URL, y así sucesivamente. Una columna de relación inversa y una columna de agregación no tienen input.

Opciones y colores

Una opción es { value, label, color, group }; solo value es obligatorio. color es uno de los nombres de la paleta gray, teal, blue, green, amber, coral, purple, pink — un nombre desconocido recurre a un color derivado del valor. group lo usa solo Estado: las opciones con el mismo grupo forman una etapa. Una cadena simple se lee como una opción con ese valor.

Agregaciones

Una columna de agregación calcula un valor a partir de las notas a las que apunta una columna de enlace de esta base de datos. El valor no se guarda en ningún archivo.

Una agregación a la que le falta una parte obligatoria, o que nombra una función que no está en esta lista, se ignora: la columna queda vacía y la base de datos se abre igualmente. Una agregación a través de otra columna calculada también queda vacía.

Campos de archivo (file.*)

Estos valores proceden del archivo, no de su frontmatter. Cada fila de una base de datos lleva lo siguiente:

CampoValor
file.nameLa propiedad title de la nota si la tiene; si no, el nombre del archivo sin .md
file.pathLa ruta relativa al vault
file.mtimeÚltima modificación, en milisegundos
file.ctimeCreación, en milisegundos, cuando el sistema de archivos la informa
file.sizeTamaño en bytes
file.tagsTodas las etiquetas de la nota, del frontmatter y del texto, cada una con #; se rellena cuando un filtro, un tablón o una vista que muestra la columna u ordena por ella las necesita
file.tasksProgreso de las casillas como done/total; se rellena para los tableros y para una vista que muestra la columna
file.dayEl día que representa el nombre de archivo de una nota diaria, según la carpeta y el formato del vault; solo lectura, y solo el campo de fecha de un calendario o una cronología puede usarlo
file.revisionUn marcador interno de cambios; no cuentes con él

file.folder funciona como fuente (ver Fuentes) pero no es una columna. file.basename, file.ext, file.links, file.backlinks, file.embeds, file.properties y file.file no se proporcionan: una columna con alguno de ellos queda vacía, y un filtro los lee como vacíos.

Filtros

Dónde viven los filtros

El filters de nivel superior contiene las fuentes: qué notas pertenecen a la base de datos. Cada vista puede llevar sus propios filters con condiciones que acotan solo esa vista; Plainva escribe ahí las condiciones. Ambos niveles se aplican a la vez. Las condiciones que un archivo mantiene en el nivel superior siguen funcionando; el próximo guardado en Plainva las traslada a cada vista.

Fuentes

FuenteExpresión
Carpetafile.folder == "Projects/Active" — la carpeta y todas sus subcarpetas; "" y "/" son todo el vault
Etiquetafile.hasTag("project") — la nota lleva exactamente esta etiqueta; un # inicial se ignora

Varias fuentes se combinan con and u or como cualquier otra condición. Una base de datos sin fuentes contiene todas las notas del vault. Los adjuntos, los archivos reservados index.md y log.md, y los archivos o carpetas cuyo nombre empieza por un punto nunca son filas.

Condiciones

Una condición es una cadena. Los valores van entre comillas dobles; \" y \\ escapan una comilla y una barra invertida. La propiedad se escribe sin prefijo o con note..

CondiciónExpresión
esstatus == "Done"
no esstatus != "Done"
contienecontains(labels, "urgent") o labels.contains("urgent")
no contiene!contains(labels, "urgent") o !labels.contains("urgent")
mayor que, menor queeffort > "3", effort < "8"
como mínimo, como máximodue >= "2026-07-01", due <= "2026-07-31"
está vacíostatus == "" o status.isEmpty()
no está vacíostatus != "" o !status.isEmpty()
tiene una etiquetafile.tags.contains("#work"), negado con !
color de encabezado, icononote.plainva.header_color == "#2a7f7b", note.plainva.icon == "lucide:pin"

Cómo se comparan los valores

and, or, not

Un objeto filters tiene exactamente uno de and, or y not en cada nivel; sus entradas son cadenas de condición u otros objetos de filtro.

ClaveCoincide cuando
andcoincide cada entrada
orcoincide al menos una entrada
notno coincide ninguna entrada

Plainva evalúa cualquier profundidad. El panel de filtros edita un nivel de grupos bajo Todas o Cualquiera (Añadir grupo); una estructura más profunda aparece como Filtro complejo (no editable), permanece en el archivo y se aplica — una condición dentro de ella que Plainva no puede leer se indica debajo como no aplicada. Un archivo antiguo con and y or uno junto al otro en un mismo nivel se lee como «todas las de and y una de or» y se escribe en la forma válida en el próximo guardado.

Lo que Plainva no puede leer

Solo se entienden las formas de las dos tablas anteriores. Todo lo demás — file.inFolder(…), file.hasLink(…), file.hasProperty(…), un número sin comillas (price > 2), && y || dentro de una misma cadena, aritmética, funciones de fecha como now(), o this — permanece en el archivo y se muestra tal cual en el panel de filtros, con la nota No se aplica: Plainva no puede leer esta condición, así que no filtra nada. La vista muestra entonces más notas que el mismo filtro en Obsidian.

Fórmulas

Plainva no calcula las fórmulas de Obsidian. formulas permanece en el archivo sin cambios, y una columna formula.<name> en el order de una vista se muestra sin valores. Exportar tabla → Fórmulas (.base) escribe algunas agregaciones como fórmulas para que Obsidian pueda calcularlas (ver Bases de datos (.base)).

Vistas

Claves de toda vista

ClaveValorEn Plainva
typetable, list, cardsEl tipo de vista; ver la tabla siguiente
nametextoObligatorio; Plainva da un nombre a una vista que no lo tenga al guardar
orderlista de ids de propiedadLas columnas visibles, en este orden
sortlista de { property, direction }Reglas de orden, ASC o DESC
filtersobjeto de filtroLas condiciones propias de la vista
summariesmapa de id de propiedad → nombre de resumenEl pie de cada columna
plainvamapaLas opciones de vista de Plainva, más abajo

Los ocho tipos de vista

Obsidian conoce table, list y cards. Los demás tipos de vista de Plainva se guardan como type: table más plainva.render, así que Obsidian los muestra como una tabla.

Tipo de vistatype en discoplainva.render
Tabla (table)table—
Lista (list)list—
Galería (gallery)cards—
Tablero (board)tableboard
Calendario (calendar)tablecalendar
Cronología (timeline)tabletimeline
Grafo (graph)tablegraph
Tablón (pinboard)tablepinboard

Tablero, Calendario, Cronología, Grafo y Tablón se ofrecen como Tipo de vista solo mientras Permitir extensiones de Plainva para archivos .base está activado. Un type que Plainva no conoce se muestra como una tabla y permanece tal cual en el archivo hasta que elijas otro Tipo de vista.

Opciones de vista (views[i].plainva)

Dentro del bloque plainva una propiedad se escribe sin prefijo (status), no como note.status.

ClaveTipos de vistaValor
renderTablero, Calendario, Cronología, Grafo, TablónEl tipo de vista, ver arriba
groupByTableroLa propiedad de la que se forman las columnas; sin ella, la propiedad del propio groupBy de Obsidian en la vista
boardLaneByTableroUna segunda propiedad para Carriles por
boardWipLimitsTableroMapa de valor de columna → máximo de tarjetas (Límite de WIP), números enteros mayores que 0
boardColorModeTablerocolumn tiñe toda la columna; si falta = solo el chip del encabezado
boardColumnOrderTableroOrden manual de las columnas; __UNGROUPED__ es la columna sin valor
colorByTablero, CronologíaLas tarjetas y las barras toman el color de opción de esta propiedad (Color según)
dateFieldCalendario, CronologíaLa fecha de inicio (Campo de fecha, Fecha de inicio); una propiedad de fecha o file.day
endFieldCalendario, CronologíaLa Fecha de fin
coverImageGaleríaLa propiedad que contiene la Imagen de portada
subItemsPropertyTablaLa relación padre para los Subelementos
widthsTablaMapa de columna → ancho en píxeles
dateFormattodoslong, iso o relative; si falta = la forma corta por defecto
graphEdgesGrafoPropiedades de relación dibujadas como aristas
graphColorByGrafoUna propiedad de selección o estado que colorea los nodos
graphSizeByGrafoUna propiedad numérica que da tamaño a los nodos
graphShowExternalGrafotrue muestra también los destinos de enlace fuera de la vista
graphShowIncomingGrafotrue muestra también los enlaces que llegan desde otras bases de datos
pinboardOrderTablónRutas de las tarjetas sin fijar, en orden manual
pinboardPinnedTablónRutas de las tarjetas fijadas, en orden
pinboardFilterByTablónOrigen de las etiquetas: una propiedad de selección múltiple; si falta = etiquetas

Opciones de todo el archivo (solo la primera vista)

Estas claves pertenecen a toda la base de datos. Plainva las escribe solo en el bloque plainva de la primera vista y lee el primer valor válido de cada una.

ClaveValor
fileIconColorColor hexadecimal del icono de la base de datos (Color del icono de la base de datos)
newItemFolderCarpeta donde Entrada guarda las entradas nuevas
newItemTemplatePlantilla para las entradas nuevas
contextFiltersPropiedades que limitan una base de datos incrustada a la nota en la que está incrustada (Esta nota)
taskListCuenta y lista ("<account id> <list id>") en la que también se crea una tarea nueva

Resúmenes

views[i].summaries asigna a una columna uno de estos nombres; el pie lo calcula sobre las filas que muestra la vista.

NombreEn PlainvaResultado
AveragePromedioMedia de los números
MinMínEl número más pequeño
MaxMáxEl número más grande
SumSumaTotal de los números
RangeRangoEl número más grande menos el más pequeño; para fechas, el intervalo en días
MedianMedianaValor central de los números
StddevDesv. típicaDesviación típica de todos los números (poblacional)
EarliestMás tempranaLa fecha más temprana
LatestMás tardíaLa fecha más tardía
CheckedMarcadasFilas cuyo valor es true o yes
UncheckedSin marcarTodas las demás filas
EmptySin valorFilas sin valor
FilledCon valorFilas con valor
UniqueDistintosNúmero de valores diferentes; las entradas de una lista cuentan una por una

Los números se redondean a dos decimales, y también se lee una coma decimal. Una columna sin ningún valor utilizable no muestra pie en lugar de 0. Cualquier otro nombre es una fórmula personalizada del summaries de nivel superior: Plainva la conserva y muestra Personalizado: … en el menú, pero no calcula ningún valor.

Orden y agrupación

Incrustar una base de datos y this

![[Projects.base]] en una nota muestra la base de datos dentro de la nota, en la vista de lectura y en el editor. Una parte tras # (un nombre de vista, como en ![[Projects.base#Board]]) se ignora: la incrustación muestra la última vista usada para esta base de datos. Un bloque de código ```base en una nota se muestra como código, no como una base de datos.

this aún no es compatible. Un filtro o una fórmula que use this permanece en el archivo, pero Plainva no lo evalúa. Dos cosas cubren el caso más habitual, «mostrar las entradas que pertenecen a esta nota»: contextFilters (Esta nota en el panel de filtros) limita una base de datos incrustada a la nota en la que está incrustada mediante una propiedad de relación, y una base de datos incrustada que se relaciona con la base de datos de su nota anfitriona ofrece por sí sola Filtrar esta base por la nota actual. Ambas actúan solo dentro de Plainva; Obsidian muestra todas las filas.

Límites

Claves que Plainva no conoce

Plainva lee un .base, cambia solo lo que cambiaste en la app y escribe el archivo entero de nuevo — como YAML con saltos de línea LF y sin BOM, de modo que los comentarios y el espaciado de un archivo escrito a mano no se conservan. De lo que no conoce:

Diferencias con Obsidian Bases

TemaObsidianPlainva
Fórmulas, resúmenes personalizadosSe calculanSe conservan, no se calculan
thisCompatibleAún no es compatible
Expresiones de filtroEl lenguaje de expresiones completoLas formas de Condiciones
file.folder == "X"Solo las notas directamente en XX y todas sus subcarpetas
file.hasTag("x")También #x/childExactamente #x
file.nameEl nombre del archivoLa propiedad title si la nota la tiene
limit, groupBy de la vistaSe aplicanlimit se conserva, no se aplica; groupBy agrupa un tablero, no una tabla
Tipos de vistatable, list, cards y tipos de pluginsOcho tipos; uno desconocido se muestra como tabla y se conserva en el archivo
![[db.base#View]]Abre esa vistaLa última vista usada
Bloque de código ```baseUna base de datosUn bloque de código
Los bloques plainva de PlainvaSe ignoranTablero, calendario, cronología, grafo, tablón, relaciones, agregaciones, tipos de campo

Ver también