obsidian-bases
Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries. Use when working with .base files, creating database-like views of notes, or when the user mentions Bases, table views, card views, filters, or formulas in Obsidian.
By freestylefly · 464 installs
npx skills add freestylefly/canghe-skills --skill obsidian-bases
Source repository · Upstream listing
Obsidian Bases Skill
This skill enables skills compatible agents to create and edit valid Obsidian Bases ( .base files) including views, filters, formulas, and all related configurations.
Overview
Obsidian Bases are YAML based files that define dynamic views of notes in an Obsidian vault. A Base file can contain multiple views, global filters, formulas, property configurations, and custom summaries.
File Format
Base files use the .base extension and contain valid YAML. They can also be embedded in Markdown code blocks.
Complete Schema
Filter Syntax
Filters narrow down results. They can be applied globally or per view.
Filter Structure
Filter Operators
Operator Description
== equals
!= not equal
greater than
< less than
= greater than or equal
<= less than or equal
&& logical and
\ \ logical or
<code !</code logical not
Properties
Three Types of Properties
1. Note properties From frontmatter: note.author or just author
2. File properties File metadata: file.name , file.mtime , etc.
3. Formula properties Computed values: formula.my formula
File Properties Reference
Property Type Description
file.name String File name
file.basename String File name without extension
file.path String Full path to file
file.folder String Parent folder path
file.ext String File extension
file.size Number File size in bytes
file.ctime Date Created time
file.mtime Date Modified time
file.tags List All tags in file
file.links List Internal links in file
file.backlinks List Files linking to this file
file.embeds List Embeds in the note
file.properties Object All frontmatter properties
The this Keyword
In main content area: refers to the base file itself
When embedded: refers to the embedding file
In sidebar: refers to the active file in main content
Formula Syntax
Formulas compute values from properties. Defined in the formulas section.
Functions Reference
Global Functions
Function Signature Description
date() date(string): date Parse string to date. Format: YYYY MM DD HH:mm:ss
duration() duration(string): duration Parse duration string
now() now(): date Current date and time
today() today(): date Current date (time = 00:00:00)
if() if(condition, trueResult, falseResult?) Conditional
min() min(n1, n2, ...): number Smallest number
max() max(n1, n2, ...): number Largest number
number() number(any): number Convert to number
link() link(path, display?): Link Create a link
list() list(element): List Wrap in list if not already
file() file(path): file Get file object
image() image(path): image Create image for rendering
icon() icon(name): icon Lucide icon by name
html() html(string): html Render as HTML
escapeHTML() escapeHTML(string): string Escape HTML characters
Any Type Functions
Function Signature Description
isTruthy() any.isTruthy(): boolean Coerce to boolean
isType() any.isType(type): boolean Check type
toString() any.toString(): string Convert to string
Date Functions & Fields
Fields: date.year , date.month , date.day , date.hour , date.minute , date.second , date.millisecond
Function Signature Description
date() date.date(): date Remove time portion
format() date.format(string): string Format with Moment.js pattern
time() date.time(): string Get time as string
relative() date.relative(): string Human readable relative time
isEmpty() date.isEmpty(): boolean Always false for dates
Date Arithmetic
String Functions
Field: string.length
Function Signature Description
contains() string.contains(value): boolean Check substring
containsAll() string.containsAll(...values): boolean All substrings present
containsAny() string.containsAny(...values): boolean Any substring present
startsWith() string.startsWith(query): boolean Starts with query
endsWith() string.endsWith(query): boolean Ends with query
isEmpty() string.isEmpty(): boolean Empty or not present
lower() string.lower(): string To lowercase
title() string.title(): string To Title Case
trim() string.trim(): string Remove whitespace
replace() string.replace(pattern, replacement): string Replace pattern
repeat() string.repeat(count): string Repeat string
reverse() string.reverse(): string Reverse string
slice() string.slice(start, end?): string Substring
split() string.split(separator, n?): list Split to list
Number Functions
Function Signature Description
abs() number.abs(): number Absolute value
ceil() number.ceil(): number Round up
floor() number.floor(): number Round down
round() number.round(digits?): number Round to digits
toFixed() number.toFixed(precision): string Fixed point notation
isEmpty() number.isEmpty(): boolean Not present
List Functions
Field: list.length
Function Signature Description
contains() list.contains(value): boolean Element exists
containsAll() list.containsAll(...values): boolean All elements exist
containsAny() list.containsAny(...values): boolean Any element exists
filter() list.filter(expression): list Filter by condition (uses value , index )
map() list.map(expression): list Transform elements (uses value , index )
reduce() list.reduce(expression, initial): any Reduce to single value (uses value , index , acc )
flat() list.flat(): list Flatten nested lists
join() list.join(separator): string Join to string
reverse() list.reverse(): list Reverse order
slice() list.slice(start, end?): list Sublist
sort() list.sort(): list Sort ascending
unique() list.unique(): list Remove duplicates
isEmpty() list.isEmpty(): boolean No elements
File Functions
Function Signature Description
asLink() file.asLink(display?): Link Convert to link
hasLink() file.hasLink(otherFile): boolean Has link to file
hasTag() file.hasTag(...tags): boolean Has any of the tags
hasProperty() file.hasProperty(name): boolean Has property
inFolder() file.inFolder(folder): boolean In folder or subfolder
Link Functions
Function Signature Description
asFile() link.asFile(): file Get file object
linksTo() link.linksTo(file): boolean Links to file
Object Functions
Function Signature Description
isEmpty() object.isEmpty(): boolean No properties
keys() object.keys(): list List of keys
values() object.values(): list List of values
Regular Expression Functions
Function Signature Description
matches() regexp.matches(string): boolean Test if matches
View Types
Table View
Cards View
List View
Map View
Requires latitude/longitude properties and the Maps community plugin.
Default Summary Formulas
Name Input Type Description
Average Number Mathematical mean
Min Number Smallest number
Max Number Largest number
Sum Number Sum of all numbers
Range Number Max Min
Median Number Mathematical median
Stddev Number Standard deviation
Earliest Date Earliest date
Latest Date Latest date
Range Date Latest Earliest
Checked Boolean Count of true values
Unchecked Boolean Count of false values
Empty Any Count of empty values
Filled Any Count of non empty values
Unique Any Count of unique values
Complete Examples
Task Tracker Base
Reading List Base
Project Notes Base
Daily Notes Index
Embedding Bases
Embed in Markdown files:
YAML Quoting Rules
Use single quotes for formulas containing double quotes: 'if(done, "Yes", "No")'
Use double quotes for simple strings: "My View Name"
Escape nested quotes properly in complex expressions
Common Patterns
Filter by Tag
Filter by Folder
Filter by Date Range
Filter by Property Value
Combine Multiple Conditions
References
[Bases Syntax](https://help.obsidian.md/bases/syntax)
[Functions](https://help.obsidian.md/bases/functions)
[Views](https://help.obsidian.md/bases/views)
[Formulas](https://help.obsidian.md/formulas)