Tables

Turn a fenced code block into a live table built from your notes' frontmatter — each matching note is a row, each frontmatter field is a column. Edit a cell and it writes straight back to that note.

Create a table

Add a fenced code block with the language base (or table). The editor replaces the block with an interactive table. The lines inside are the table's configuration — one keyword value per line; blank lines and # comments are ignored.

```base
title Reading list
columns file author year rating
filter tags to-read
sort year desc
```

Configuration

Every keyword is optional. With none, you get an untitled table of all notes that have frontmatter.

titleHeading shown above the table.
title Reading list
columnsFrontmatter fields to show as columns (space- or comma-separated). The built-in file and path columns are always available and read-only.
columns file author year rating
filterOnly include notes whose field contains value (case-insensitive substring; for list fields, matches if any item contains it). The value may contain spaces.
filter tags to-read
sortOrder rows by a field. Direction is asc or desc (default asc). Numbers sort numerically; everything else sorts naturally.
sort year desc

Which notes appear

  • Scans .md / .markdown files in the current vault (up to 500).
  • Includes only notes that start with a YAML frontmatter block (--- ---).
  • Applies your filter, then sort, and shows up to 100 rows.
  • Frontmatter is read line by line as key: value; [a, b]becomes a list. Nested YAML isn't supported.

Editing cells

Click any cell except file and path and type; press Enteror click away to save. The value is written back into that note's frontmatter, creating the key if it's missing (the note must already have a frontmatter block).

Types are preserved: lists stay [a, b], true/false stay booleans, numbers stay numbers, everything else is written as text.

Toolbar

The buttons above the table edit the configuration block in place, so your changes are saved into the note.

SortSet the sort field and direction.
FilterSet the filter field and value.
PropertiesToggle which columns show, or add a new one.
SourceJump the cursor into the block to edit the config by hand.