User Guide

Linking and Organising

Build a connected web of thought using wiki links, reciprocal backlinks, workspace tags and instant search.

Wiki links: [[Note]]

Type double square brackets around a note name to create an internal reference: [[Project Roadmap]]. You can also specify an alias using a pipe separator: [[Project Roadmap|the roadmap]].

When you click a wiki link in the rendered preview:

  • If the note exists in your workspace, Tessamark opens it immediately.
  • If the target does not exist yet on macOS or iOS, Tessamark creates <Title>.md in the same folder as the current note, starting with a # <Title> heading, opens it in the editor, and keeps your cursor ready to write. On Linux, if not found relative to the document or workspace, it creates the file in the workspace folder. On Android, a notice reports that no note with that title exists yet.

Backlinks

Tessamark indexes references in both directions. The backlinks panel lists every document in your workspace that contains a [[wiki link]] to the currently active note. Plain mentions of the note's name do not count, and a note linking to itself is left out.

Selecting any backlink item jumps directly into that source document, making connections visible without requiring manual indexing.

Tags and the tag filter

Add tags anywhere in your document body with a hash symbol (for example, #research or #meeting) or in YAML front matter under the tags: key at the top of your file.

The workspace sidebar maintains an updated list of all unique tags across your workspace under the Tags section. Selecting a tag filters your workspace file tree down to a flat list of notes containing that tag, with a Clear button to restore the full tree.

Today's note and its settings

The Today's Note command jumps straight to a dated journal entry. If the document already exists on disk, Tessamark opens it; if not, Tessamark creates the file in your configured daily notes folder, populates it from your template, and opens it.

Under Settings → General → Daily Notes, you can customise:

  • Folder: the directory path relative to your workspace root where daily notes live (such as daily).
  • Template Path: an optional Markdown template file. The template supports variables: {{date}}, {{date_long}}, {{time}} and {{title}}.
Platform Where to find it
macOS File → Today's Note (⇧⌘T)
iPad Today's Note toolbar button (leading edge, regular width); with a hardware keyboard, ⇧⌘T. It is not in the iPhone overflow menu.
Linux Today's Note in the main menu (Ctrl+Shift+T)
Android Today's Note in the More (⋮) menu

Workspace search

Search quickly across note titles and content in your workspace. The shared Rust core runs ranked search against your notes, returning matching excerpts with highlight offsets.

  1. Open the search field in the workspace sidebar (or trigger the search command).
  2. Type keywords into the search box.
  3. Click any matching result to open the target note directly at that excerpt.
Platform Where to find it
macOS Search field at the top of the Workspace Explorer sidebar
iPhone and iPad Search field at the top of the Workspace Explorer sidebar
Linux Search Workspace (Ctrl+Shift+F)
Android Search in the More (⋮) menu

Back and forward

When moving across notes via wiki links or search results, Tessamark maintains a session history stack. You can step backward to return to earlier documents and forward again.

Platform Where to find it
macOS Chevron buttons in the Knowledge Graph panel (Pro); ⌘[ for Back and ⌘] for Forward
iPhone and iPad Chevron left and right buttons in the Knowledge Graph panel (Pro); open the panel from Knowledge Graph (iPad toolbar, or iPhone overflow menu → Panels). They are not general toolbar buttons.
Linux Header bar navigation arrows (Alt+Left and Alt+Right)
Android Go Back and Go Forward in the More (⋮) menu

Next: Version history →