Datenbank-Referenz (.base)

Stand: 2026-11-03

Diese Seite listet auf, was eine .base-Datei enthalten kann und was Plainva mit jedem Teil macht: jeden Schlüssel der obersten Ebene, jede Filterform, jeden Ansichtstyp mit seinen Optionen, Zusammenfassungen, Sortierung, Grenzen, was mit Schlüsseln geschieht, die Plainva nicht kennt, und wo sich Plainva anders verhält als Obsidian Bases. Sie beschreibt, was der Code von Plainva heute liest, auswertet und schreibt — nicht die Dokumentation von Obsidian.

Für den Alltag lies zuerst Datenbanken (.base). Die Regeln, die ein Werkzeug einhalten muss, wenn es Vault-Dateien direkt schreibt, und das vollständige Relations-Beispiel stehen in der Dateiformat-Referenz.

Auf einen Blick

Teil der DateiWas Plainva damit macht
filtersLiest und wendet die Quellen (Ordner, Tag) und die Bedingungen an, die unter Filter stehen
viewsLiest alle acht Ansichtstypen, ihre Reihenfolge, Sortierung, Filter und Zusammenfassungen
propertiesLiest das Spaltenschema, den Anzeigenamen und den plainva-Block von Plainva
summaries (Ansicht)Berechnet die vierzehn eingebauten Zusammenfassungen
formulasBehält sie in der Datei, berechnet sie nicht
summaries (oberste Ebene)Behält eigene Zusammenfassungsformeln, berechnet sie nicht
thisNoch nicht unterstützt
Andere SchlüsselBehält sie in der Datei (siehe Schlüssel, die Plainva nicht kennt)

Schlüssel der obersten Ebene

Eine .base-Datei ist YAML mit diesen Schlüsseln auf oberster Ebene. Alle sind optional; eine Datei ohne views öffnet sich mit einer Tabelle.

SchlüsselInhaltIn Plainva
filtersWelche Notizen zur Datenbank gehören (Quellen)Gelesen und angewendet
propertiesEin Eintrag je Spalte, benannt nach der Eigenschafts-IDGelesen; die Ergänzungen von Plainva stehen in ihrem plainva-Block
viewsDie Liste der AnsichtenGelesen; jede Ansicht braucht einen name
formulasObsidian-Formeln, name: expressionUnverändert behalten, nicht berechnet
summariesEigene Zusammenfassungsformeln von ObsidianUnverändert behalten, nicht berechnet

Plainva schreibt nie einen weiteren Schlüssel auf oberster Ebene: Obsidian öffnet eine .base mit einem Schlüssel, den es nicht kennt, nicht. Ein Schlüssel columns: auf oberster Ebene, den sehr alte Plainva-Versionen geschrieben haben, wird weiterhin gelesen und beim nächsten Speichern der Datei nach properties verschoben.

Eigenschaften (properties)

Eigenschafts-IDs

Eine Eigenschafts-ID benennt eine Spalte. Es gibt drei Arten:

IDBedeutetBeispiel
note.<key>Ein Schlüssel im Frontmatter der Notizennote.status
file.<field>Eine Angabe zur Datei (siehe Dateifelder)file.mtime
formula.<name>Eine Obsidian-Formel aus formulasformula.price_per_unit

Die Schlüssel von properties, das order einer Ansicht und sort[].property verwenden diese IDs. In einem Filterausdruck und in einem plainva-Block steht ein Frontmatter-Schlüssel ohne Präfix (status); ein Filterausdruck versteht auch note.status.

Schreibt eine Notiz einen Schlüssel in anderer Groß-/Kleinschreibung als die Spalte (Due gegenüber der Spalte due), zeigt Plainva den Wert trotzdem in dieser Spalte und schreibt Änderungen unter der Schreibweise der Notiz zurück.

Anzeigename

properties.<id>.displayName ist die Spaltenbeschriftung von Obsidian. Plainva zeigt sie als Spaltenkopf und behält sie. Ohne sie wird ein Frontmatter-Schlüssel mit großem Anfangsbuchstaben gezeigt (nur auf dem Bildschirm); die Dateifelder haben eigene Namen, zum Beispiel Name, Geändert, Größe, Pfad, Checkliste und Tag aus dem Dateinamen.

Der plainva-Block einer Spalte

Alles, was Plainva zu einer Spalte hinzufügt, steht unter properties.<id>.plainva. Obsidian ignoriert es.

SchlüsselWertBedeutung
inputein Feldtyp (Liste unten)Der Feldtyp der Spalte
ratingMaxZahl, 1 bis 10Wie viele Marken eine Bewertung hat (Standard 5)
ratingGlyphein ZeichenDie Marke, die eine Bewertung zeichnet (Standard ein Punkt)
optionsListe von OptionenFeste Werte für Auswahl, Status und Mehrfachauswahl
relationBase.base-Pfad relativ zum VaultDie Datenbank, auf die eine Relation zeigt
relationLimitoneEine Relation enthält genau einen Link; fehlt der Schlüssel, gibt es keine Begrenzung
reverseOf{ base, property }Eine berechnete Rückrelations-Spalte
rollup{ through, of, fn, where }Eine berechnete Auswertungsspalte (siehe Auswertungen)
previousKeysListe von bis zu 8 früheren NamenLässt Kommentare eine umbenannte Spalte wiederfinden

Feldtypen (input)

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

Zwei ältere Schreibweisen werden ebenfalls gelesen: multi-select als multiselect und link als relation. Eine Spalte ohne input — oder mit einem Wert, der nicht in dieser Liste steht — bekommt ihren Typ aus den Werten in den Notizen: true/false ist ein Kontrollkästchen, eine Zahl eine Zahl, eine Liste von [[links]] eine Relation, 2026-07-03 ein Datum, eine Webadresse eine URL und so weiter. Eine Rückrelations-Spalte und eine Auswertungsspalte haben kein input.

Optionen und Farben

Eine Option ist { value, label, color, group }; nur value ist Pflicht. color ist einer der Palettennamen gray, teal, blue, green, amber, coral, purple, pink — ein unbekannter Name fällt auf eine aus dem Wert abgeleitete Farbe zurück. group wird nur bei Status verwendet: Optionen mit derselben Gruppe bilden eine Stufe. Eine einfache Zeichenkette wird als Option mit diesem Wert gelesen.

Auswertungen

Eine Auswertungsspalte berechnet einen Wert aus den Notizen, auf die eine Verknüpfungsspalte dieser Datenbank zeigt. Der Wert wird in keiner Datei gespeichert.

Eine Auswertung, der ein Pflichtteil fehlt oder die eine Funktion nennt, die nicht in dieser Liste steht, wird ignoriert: Die Spalte bleibt leer, und die Datenbank öffnet sich trotzdem. Auch eine Auswertung über eine andere berechnete Spalte bleibt leer.

Dateifelder (file.*)

Diese Werte stammen aus der Datei, nicht aus ihrem Frontmatter. Jede Zeile einer Datenbank trägt Folgendes:

FeldWert
file.nameDie Eigenschaft title der Notiz, falls sie eine hat, sonst der Dateiname ohne .md
file.pathDer Pfad relativ zum Vault
file.mtimeZuletzt geändert, in Millisekunden
file.ctimeErstellt, in Millisekunden, soweit das Dateisystem es meldet
file.sizeGröße in Bytes
file.tagsAlle Tags der Notiz, aus Frontmatter und Text, jeweils mit #; gefüllt, wenn ein Filter, eine Pinnwand oder eine Ansicht, die die Spalte zeigt oder nach ihr sortiert, sie braucht
file.tasksFortschritt der Kontrollkästchen als done/total; gefüllt für Boards und für eine Ansicht, die die Spalte zeigt
file.dayDer Tag, für den der Dateiname einer Tagesnotiz steht, nach Ordner und Format des Vaults; nur lesbar, und nur das Datumsfeld eines Kalenders oder einer Zeitleiste kann es verwenden
file.revisionEine interne Änderungsmarke; verlass Dich nicht darauf

file.folder funktioniert als Quelle (siehe Quellen), ist aber keine Spalte. file.basename, file.ext, file.links, file.backlinks, file.embeds, file.properties und file.file gibt es nicht: Eine Spalte mit einem davon bleibt leer, und ein Filter liest sie als leer.

Filter

Wo Filter stehen

Der filters-Schlüssel auf oberster Ebene enthält die Quellen — welche Notizen zur Datenbank gehören. Jede Ansicht kann eigene filters mit Bedingungen tragen, die nur diese Ansicht eingrenzen; Plainva schreibt die Bedingungen dorthin. Beide Ebenen gelten zusammen. Bedingungen, die eine Datei auf oberster Ebene behält, funktionieren weiterhin; beim nächsten Speichern in Plainva werden sie in jede Ansicht verschoben.

Quellen

QuelleAusdruck
Ordnerfile.folder == "Projects/Active" — der Ordner und alle Unterordner; "" und "/" sind der ganze Vault
Tagfile.hasTag("project") — die Notiz trägt genau diesen Tag; ein führendes # wird ignoriert

Mehrere Quellen werden wie jede andere Bedingung mit and oder or verknüpft. Eine Datenbank ohne Quellen enthält jede Notiz des Vaults. Anhänge, die reservierten Dateien index.md und log.md sowie Dateien oder Ordner, deren Name mit einem Punkt beginnt, sind nie Zeilen.

Bedingungen

Eine Bedingung ist eine Zeichenkette. Werte stehen in doppelten Anführungszeichen; \" und \\ maskieren ein Anführungszeichen und einen Backslash. Die Eigenschaft steht ohne Präfix oder mit note..

BedingungAusdruck
iststatus == "Done"
ist nichtstatus != "Done"
enthältcontains(labels, "urgent") oder labels.contains("urgent")
enthält nicht!contains(labels, "urgent") oder !labels.contains("urgent")
größer als, kleiner alseffort > "3", effort < "8"
mindestens, höchstensdue >= "2026-07-01", due <= "2026-07-31"
ist leerstatus == "" oder status.isEmpty()
ist nicht leerstatus != "" oder !status.isEmpty()
hat einen Tagfile.tags.contains("#work"), mit ! verneint
Kopfzeilenfarbe, Iconnote.plainva.header_color == "#2a7f7b", note.plainva.icon == "lucide:pin"

Wie Werte verglichen werden

and, or, not

Ein filters-Objekt hat auf jeder Ebene genau eines von and, or und not; seine Einträge sind Bedingungs-Zeichenketten oder weitere Filterobjekte.

SchlüsselTrifft zu, wenn
andjeder Eintrag zutrifft
ormindestens ein Eintrag zutrifft
notkein Eintrag zutrifft

Plainva wertet jede Tiefe aus. Das Filter-Panel bearbeitet eine Ebene von Gruppen unter Alle oder Beliebige (Gruppe hinzufügen); eine tiefere Struktur erscheint als Komplexer Filter (nicht editierbar), bleibt in der Datei und wird angewendet — eine Bedingung darin, die Plainva nicht lesen kann, wird darunter als nicht angewendet genannt. Eine ältere Datei mit and und or nebeneinander auf einer Ebene wird als „alle aus and und eines aus or“ gelesen und beim nächsten Speichern in der gültigen Form geschrieben.

Was Plainva nicht lesen kann

Verstanden werden nur die Formen in den beiden Tabellen oben. Alles andere — file.inFolder(…), file.hasLink(…), file.hasProperty(…), eine Zahl ohne Anführungszeichen (price > 2), && und || innerhalb einer Zeichenkette, Arithmetik, Datumsfunktionen wie now() oder this — bleibt in der Datei und wird im Filter-Panel wie geschrieben angezeigt, mit dem Hinweis Nicht angewendet: Plainva kann diese Bedingung nicht lesen, sie filtert nichts. Die Ansicht zeigt dann mehr Notizen als derselbe Filter in Obsidian.

Formeln

Plainva berechnet keine Obsidian-Formeln. formulas bleibt unverändert in der Datei, und eine Spalte formula.<name> im order einer Ansicht wird ohne Werte angezeigt. Tabelle exportieren → Formeln (.base) schreibt einige Auswertungen als Formeln, damit Obsidian sie berechnen kann (siehe Datenbanken).

Ansichten

Schlüssel jeder Ansicht

SchlüsselWertIn Plainva
typetable, list, cardsDer Ansichtstyp; siehe die nächste Tabelle
nameTextPflicht; eine Ansicht ohne Namen bekommt beim Speichern von Plainva einen
orderListe von Eigenschafts-IDsDie sichtbaren Spalten in dieser Reihenfolge
sortListe von { property, direction }Sortierregeln, ASC oder DESC
filtersFilterobjektDie eigenen Bedingungen der Ansicht
summariesZuordnung Eigenschafts-ID → Name der ZusammenfassungDie Fußzeile jeder Spalte
plainvaZuordnungDie Ansichtsoptionen von Plainva, unten

Die acht Ansichtstypen

Obsidian kennt table, list und cards. Die übrigen Ansichtstypen von Plainva werden als type: table plus plainva.render gespeichert, sodass Obsidian sie als Tabelle zeigt.

Ansichtstyptype auf dem Datenträgerplainva.render
Tabelle (table)table—
Liste (list)list—
Galerie (gallery)cards—
Board (board)tableboard
Kalender (calendar)tablecalendar
Zeitleiste (timeline)tabletimeline
Graph (graph)tablegraph
Pinnwand (pinboard)tablepinboard

Board, Kalender, Zeitleiste, Graph und Pinnwand werden als Ansichtstyp nur angeboten, solange Plainva-Erweiterungen für .base Dateien erlauben eingeschaltet ist. Ein type, den Plainva nicht kennt, wird als Tabelle gezeigt und bleibt wie geschrieben in der Datei, bis Du einen anderen Ansichtstyp wählst.

Ansichtsoptionen (views[i].plainva)

Innerhalb des plainva-Blocks steht eine Eigenschaft ohne Präfix (status), nicht als note.status.

SchlüsselAnsichtstypenWert
renderBoard, Kalender, Zeitleiste, Graph, PinnwandDer Ansichtstyp, siehe oben
groupByBoardDie Eigenschaft, aus der die Spalten bestehen; ohne sie die Eigenschaft des eigenen groupBy der Ansicht von Obsidian
boardLaneByBoardEine zweite Eigenschaft für Spuren nach
boardWipLimitsBoardZuordnung Spaltenwert → höchste Kartenzahl (WIP-Limit), ganze Zahlen über 0
boardColorModeBoardcolumn tönt die ganze Spalte; fehlt der Schlüssel, nur der Chip in der Überschrift
boardColumnOrderBoardManuelle Spaltenreihenfolge; __UNGROUPED__ ist die Spalte ohne Wert
colorByBoard, ZeitleisteKarten und Balken übernehmen die Optionsfarbe dieser Eigenschaft (Farbe nach)
dateFieldKalender, ZeitleisteDas Startdatum (Datumsfeld, Startdatum); eine Datums-Eigenschaft oder file.day
endFieldKalender, ZeitleisteDas Enddatum
coverImageGalerieDie Eigenschaft, die das Titelbild enthält
subItemsPropertyTabelleDie Eltern-Relation für Unterelemente
widthsTabelleZuordnung Spalte → Breite in Pixeln
dateFormatallelong, iso oder relative; fehlt der Schlüssel, gilt die kurze Standardform
graphEdgesGraphRelations-Eigenschaften, die als Kanten gezeichnet werden
graphColorByGraphEine Auswahl- oder Status-Eigenschaft, die die Knoten einfärbt
graphSizeByGraphEine Zahlen-Eigenschaft, die die Größe der Knoten bestimmt
graphShowExternalGraphtrue zeigt auch Linkziele außerhalb der Ansicht
graphShowIncomingGraphtrue zeigt auch Links, die aus anderen Datenbanken hereinkommen
pinboardOrderPinnwandPfade der nicht angepinnten Karten in manueller Reihenfolge
pinboardPinnedPinnwandPfade der angepinnten Karten in Reihenfolge
pinboardFilterByPinnwandLabel-Quelle: eine Mehrfachauswahl-Eigenschaft; fehlt der Schlüssel, sind es die Tags

Optionen für die ganze Datei (nur erste Ansicht)

Diese Schlüssel gehören zur ganzen Datenbank. Plainva schreibt sie nur in den plainva-Block der ersten Ansicht und liest von jedem den ersten gültigen Wert.

SchlüsselWert
fileIconColorHex-Farbe des Datenbank-Icons (Icon-Farbe der Datenbank)
newItemFolderOrdner, in dem Eintrag neue Einträge ablegt
newItemTemplateVorlage für neue Einträge
contextFiltersEigenschaften, die eine eingebettete Datenbank auf die Notiz begrenzen, in die sie eingebettet ist (Diese Notiz)
taskListKonto und Liste ("<account id> <list id>"), in der eine neue Aufgabe zusätzlich angelegt wird

Zusammenfassungen

views[i].summaries ordnet einer Spalte einen dieser Namen zu; die Fußzeile berechnet ihn über die Zeilen, die die Ansicht zeigt.

NameIn PlainvaErgebnis
AverageDurchschnittMittelwert der Zahlen
MinKleinsterKleinste Zahl
MaxGrößterGrößte Zahl
SumSummeSumme der Zahlen
RangeSpanneGrößte minus kleinste Zahl; bei Daten die Spanne in Tagen
MedianMedianMittlerer Wert der Zahlen
StddevStandardabw.Standardabweichung aller Zahlen (Grundgesamtheit)
EarliestFrühestesFrühestes Datum
LatestSpätestesSpätestes Datum
CheckedAngehaktZeilen, deren Wert true oder yes ist
UncheckedNicht angehaktAlle anderen Zeilen
EmptyOhne WertZeilen ohne Wert
FilledMit WertZeilen mit Wert
UniqueVerschiedeneAnzahl verschiedener Werte; Listeneinträge zählen einzeln

Zahlen werden auf zwei Dezimalstellen gerundet, und auch ein Dezimalkomma wird gelesen. Eine Spalte ohne brauchbaren Wert zeigt keine Fußzeile statt 0. Jeder andere Name ist eine eigene Formel aus den summaries der obersten Ebene: Plainva behält sie und zeigt Benutzerdefiniert: … im Menü, berechnet aber keinen Wert.

Sortierung und Gruppierung

Eine Datenbank einbetten, und this

![[Projects.base]] in einer Notiz zeigt die Datenbank in der Notiz, in der Leseansicht und im Editor. Ein Teil nach # (ein Ansichtsname, wie in ![[Projects.base#Board]]) wird ignoriert: Die Einbettung zeigt die Ansicht, die zuletzt für diese Datenbank verwendet wurde. Ein ```base-Codeblock in einer Notiz wird als Code gezeigt, nicht als Datenbank.

this wird noch nicht unterstützt. Ein Filter oder eine Formel, die this verwendet, bleibt in der Datei, aber Plainva wertet sie nicht aus. Zwei Dinge decken den häufigsten Fall ab, „zeige die Einträge, die zu dieser Notiz gehören“: contextFilters (Diese Notiz im Filter-Panel) begrenzt eine eingebettete Datenbank über eine Relations-Eigenschaft auf die Notiz, in die sie eingebettet ist, und eine eingebettete Datenbank, die sich auf die Datenbank ihrer Wirtsnotiz bezieht, bietet von sich aus Diese Datenbank auf die aktuelle Notiz filtern an. Beides wirkt nur innerhalb von Plainva; Obsidian zeigt alle Zeilen.

Grenzen

Schlüssel, die Plainva nicht kennt

Plainva liest eine .base, ändert nur, was Du in der App geändert hast, und schreibt die ganze Datei neu — als YAML mit LF-Zeilenenden und ohne BOM, sodass Kommentare und die Abstände einer von Hand geschriebenen Datei nicht erhalten bleiben. Von dem, was es nicht kennt:

Unterschiede zu Obsidian Bases

ThemaObsidianPlainva
Formeln, eigene ZusammenfassungenBerechnetBehalten, nicht berechnet
thisUnterstütztNoch nicht unterstützt
FilterausdrückeDie volle AusdrucksspracheDie Formen unter Bedingungen
file.folder == "X"Nur Notizen direkt in XX und alle Unterordner
file.hasTag("x")Auch #x/childGenau #x
file.nameDer DateinameDie Eigenschaft title, falls die Notiz eine hat
limit, groupBy einer AnsichtAngewendetlimit behalten, nicht angewendet; groupBy gruppiert ein Board, keine Tabelle
Ansichtstypentable, list, cards und Plugin-TypenAcht Typen; ein unbekannter wird als Tabelle gezeigt und bleibt in der Datei
![[db.base#View]]Öffnet diese AnsichtDie zuletzt verwendete Ansicht
```base-CodeblockEine DatenbankEin Codeblock
plainva-Blöcke von PlainvaIgnoriertBoard, Kalender, Zeitleiste, Graph, Pinnwand, Relationen, Auswertungen, Feldtypen

Siehe auch