Notes

Markdown syntax

Standard markdown

Notes uses GitHub-flavored markdown for everything you'd expect:

  • bold, italic, inline code
  • Headings (#, ##, …)
  • Bulleted, ordered, and task lists
  • Tables
  • Fenced code blocks
  • Blockquotes

Inline extensions

Two extensions extend standard markdown without falling back to HTML.

Entity mentions

@[](entity:01HX9Z…)

References a structured entity by id. The display name is resolved at render time, so renaming an entity automatically updates every note that mentions it. Never store a stale label.

Date references

[[date:2026-04-28]]

Marks a calendar date. The agenda and reminders views use these to surface notes by day.

Storage

The text above is exactly what's persisted. Nothing is converted to HTML or to an internal AST on disk — your notes are portable markdown.