User Guide

Reference documentation for every feature

Guide navigation

Note Types

OikoNotes stores notes as Markdown documents with metadata for category, status, tags, and AI permissions. Formal structures such as meetings, recipes, project briefs, and reference notes are handled by templates rather than custom note-type records.

Knowledge Notes

These categories support the Zettelkasten workflow:

Fleeting

Quick captures of ideas, observations, or source fragments. Fleeting notes are raw material for later review.

Literature

Notes taken while reading, watching, or listening to external sources. They keep attribution near the ideas you want to reuse.

Permanent

Atomic, durable notes written in your own words. Permanent notes link to related ideas and become the backbone of the graph.

Index

Hub notes for a topic. An index note links to related permanent and literature notes and gives you an entry point into a subject.

Capture Categories

Practical categories let quick capture route everyday work without forcing everything into long-form notes.

CategoryUse forQuick capture
TaskStructured actions with status, due date, project, or priority metadata/task, /t
TodoQuick checklist items or lightweight actions/todo
ShoppingShopping list items with quantities and check-off workflow/shop, /shopping
Food DiaryMeal logs and nutrition estimates/food, /meal
BudgetBudget or expense tracking entries/budget, /b
EventCalendar events and schedule ideas/event, /e

Templates Replace Structured Types

Meeting minutes, diary entries, recipes, project plans, code notes, travel plans, and reference material are now template-driven. Create or edit those layouts in Settings > Notes and apply them when creating a note.

This keeps note categories stable while letting each user define the structure that fits their work.

Note Metadata

Every note stores metadata alongside the Markdown content:

FieldDescription
idUnique identifier
titleNote title
createdCreation timestamp
updatedLast modification timestamp
note_typeCategory such as fleeting, permanent, task, todo, shopping, food_diary, or budget
statusWorkflow status: inbox, triaged, or published
tagsTags used for filtering and organisation
allow_aiWhether AI is allowed to process this note
revRevision counter incremented on save