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 datastores?

FIXME this calculation overflows for large inputs.

The annotation content begins at the annotation and continues through the end of the line/paragraph.

Inline Highlighting

MoreInfo highlights annotation keywords in the editor as you type — each type in a distinct color so they stand out from surrounding text at a glance. It's a quick way to see annotations in the current note.

The Annotations Widget

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

• A filter for showing/hiding different kinds of annotations
• 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 by removing the annotation marker and replacing it with [ ]. Everything will be updated accordingly.

[ ] Update this section once the API is finalised