Annotations

Annotations are in-editor markers that highlight important text without requiring a formal task or checkbox. They're for things you want to remember without creating a commitment.

The Four Types

Write them anywhere in a note, as part of normal prose:

TODO update this section once the API is finalised.

The algorithm works correctly NOTE but it hasn't been profiled yet.

IDEA could this be extended to support multiple vaults?

FIXME this calculation overflows for large inputs.

Inline Highlighting

MoreInfo highlights annotation keywords in the editor as you type — each type in a distinct colour so they stand out from surrounding text at a glance. The highlighting does not affect the underlying file: it's purely visual.

The Annotations Widget

The Annotations widget in the sidebar panel aggregates every annotation across your entire vault, organised by type. Each entry shows:

• The annotation text (the rest of the line after the keyword)
• The note it lives in
• A one-click jump directly to that line in the editor

Clicking an annotation navigates to the note and scrolls to the exact location.

Annotations vs Tasks

Annotations are intentionally stateless — there's no checkbox, no "complete" state, no done/not-done. Use them for:

• Temporary reminders while drafting
• Context flags for future readers (including yourself)
• Ideas that aren't commitments yet
• Things to fix someday but not necessarily today

When something grows into a real commitment that needs tracking, promote it to a task:

- [ ] Update this section once the API is finalised