Skip to content

Notes & Editing

Tessera uses a card-based interface where each card is a separate note, backed by a plain Markdown file.


Viewing notes

All notes in the active project are displayed simultaneously on the lighttable grid. Each card shows a rendered Markdown preview of the note's content.

  • Cards with no content display a placeholder: "Click to edit note..."
  • Markdown is rendered with full support for headings, lists, links, images, code blocks, and more.

Keyboard-first flow

For faster capture, use the search bar to filter existing notes as you type. If nothing matches, press Enter to create a new note instantly from your query.


Editing a note

  1. Click anywhere on the rendered preview to enter edit mode.
  2. A plain-text Markdown editor appears. Write or modify your content.
  3. Click Save to persist your changes and return to preview mode.
  4. Click Cancel to discard any unsaved changes and return to the previous content.

Tip

Focus goes directly to the editor when you click to edit, so you can start typing immediately.


Undo & Redo

While in the editor, Tessera provides a custom undo/redo system:

Action Shortcut
Undo Cmd+Z (macOS) or Ctrl+Z
Redo Cmd+Shift+Z / Cmd+Y (macOS) or Ctrl+Shift+Z / Ctrl+Y
  • Edits are grouped into snapshots automatically (every 300ms pause in typing).
  • The undo history holds up to 200 states.
  • History resets when you open or close the editor.

Editing the title

Each card has an editable title at the top. Click the title to modify it.

  • Press Enter to confirm (the title field will blur).
  • Only plain text is allowed — pasting rich content is automatically stripped to plain text.

Note

Title changes are visual within the current session. The underlying file name is set when the note is created.


Deleting a note

Click the trash icon (🗑) in the top-right corner of a card. You'll be asked to confirm. Deleting a note also removes all associated images.

Warning

Deletion is permanent. The Markdown file and its image folder are removed from disk.