A node
A node is one Markdown file. Its id is its path without.md, for example people/dana-wu.
key:: value.
Types
A type, also called a supertag, is one YAML file inschema/. It names a folder, a default visibility and a set of fields.
The built-in types are: person, project, meeting, decision, belief, concept, essay, idea, goal, task, book, event, place, period, dream, day, source and page.
type: in its frontmatter. For older pages without one, the first tag that matches a type is used.
Field types
Computed fields aggregate over other nodes. For example a person’s
last_contact is the latest date of any meeting that lists them in people.
Automatic structure for new pages
When a page is added throughcapture, add, the web app or an importer, the tool fills in structure:
- If you give no type,
brain add auto "<title>"infers one from the title and body. - Names of existing pages in the body become links.
- Typed references are filled, for example the people on a meeting.
inferred: in the frontmatter so it can be reviewed. Anything you set yourself is kept.
Visibility
Each node ispublic, private or secret. The type sets the default and a node can override it in frontmatter. Only public nodes are ever published outside the vault, and secret nodes are never sent to a language model.