Skip to content

The note editor

The editor is Aletheia's home surface — where you read and write notes. It pairs a rich-text/Markdown body with a live metadata sidecar that shows what the note is about.

A note open in the editor with the metadata sidecar.

A meeting note open in Rich view. People are rendered as entity chips inline; the sidecar (right) shows the note's entities, tags, action items, and links.

The note metadata header above the body.

Every note carries a metadata header above its body. **①** Updated timestamp · **②** Word count · **③** Source badge.

The workspace (no note open)

Open the Editor with nothing selected and you get the workspace — a filterable table of your entire library: title, tags, notebook, source, and dates. Search titles, filter by tag or notebook, filter by source (manual, joplin, chat, email, …), or sort by any column. It's the fastest way to eyeball everything you've got. Click any row to open it.

Opening & creating notes

  • Open — click a note in the notebooks tree or the workspace table.
  • Create+ New note (top-right of the editor) or right-click a notebook → New note. A new note is created, named, and opened for you.
  • Notes autosave. The ✓ saved indicator in the toolbar confirms it; you never hit a save button.

The editor toolbar action buttons.

The editor toolbar bundles the note-level actions. **①** Find in Note · **②** Chips toggle · **③** History · **④** Reprocess · **⑤** New note.

The three view modes

The segmented control in the toolbar switches how the body is shown:

The Rich / Split / Code view toggle in the editor toolbar.

The view-mode toggle cycles the body between Rich, Split, and Code.
Mode What you get Use it when
Rich WYSIWYG — headings, lists, tables, chips, images rendered Everyday reading & writing
Split Rich on the left, Markdown source on the right, in sync You want to see/tweak the raw Markdown while you write
Code Raw Markdown source only, with syntax highlighting Bulk edits, pasting Markdown, fixing formatting

The editor in Split view — rich pane beside the Markdown source.

Split view: the rendered note and its Markdown source, side by side and scroll-synced.

The view mode lives in the URL (?view=rich|split|code), so a link to a note can preserve it.

Formatting

Everything you'd expect, from the toolbar or Markdown shortcuts:

  • Blocks — Headings (H1–H3), bullet & numbered lists (nestable), blockquotes, code blocks, horizontal rules, tables.
  • Inlinebold, italic, strikethrough, code, links, and a font-color picker.
  • Insert — images, file attachments, tables, and inline tokens (note-links, tags, entities) via the insert modal.
  • Markdown as you type# for a heading, - for a bullet, > for a quote, and so on.

Chips: your notes are alive

In Rich view, three kinds of text become interactive chips:

  • Entities (@Mara Castellan) render as chips that open that person/org/project.
  • Tags (#project/orion) render as chips that jump to a filtered search.
  • Note-links ([[note:…|quote]]) render as citation pills that open the linked note and scroll to the quote.

The Chips ✓ toggle in the toolbar turns this rendering on/off if you'd rather see the raw tokens while editing.

People rendered as entity chips inline in the note body.

Named people become clickable entity chips right in the prose. **①** Mara Castellan · **②** Julian Rao · **③** Priya Desai.

Find (and replace) in a note

Find in Note (toolbar, or ⌘F / Ctrl+F) opens an in-note find bar with next/previous, a match counter, and replace / replace-all. It supports case-sensitive and whole-word matching — handy for renaming a term consistently within a long note.

The Find in Note button in the editor toolbar.

The Find in Note button (highlighted) opens the in-note find-and-replace bar.

Reprocess

Reprocess re-runs extraction on the current note. You rarely need it — extraction runs automatically on save — but it's the right button if you've heavily edited a note and want its entities/tags/chunks refreshed immediately rather than waiting.

History

History opens the note's revision timeline. Every save is versioned; you can view and restore any earlier version. This is your safety net against a bad edit.

Drag & drop

  • Drop a .md file onto the editor and it's imported as a new note.
  • Drop any other file and it's attached to the current note (see History & attachments).

Best practice — write naturally, let extraction do the filing

Don't hand-tag everything or manually list attendees. Write the meeting note the way you'd write it in any editor — name people in prose, mention the project — and the pipeline turns that into entities, tags, and links. The chips in the screenshot above were all extracted from ordinary sentences.

Things to watch out for

  • Extraction is a few seconds behind you. Right after saving, the sidecar may briefly show "Loading…" or fewer entities than the finished result. Give it a moment.
  • Code view is literal. Pasting rich content into Code view pastes raw Markdown — switch to Rich to paste formatted content, or Code to paste Markdown source.
  • Reprocess costs a pipeline run. It's cheap, but don't hammer it; automatic extraction already handles normal edits.

Next: The metadata sidecar →