logo
Install
Docs
Releases
Install
Docs
Releases
logo
What Fold is
Getting started
Sessions
Workspaces
Remote sessions
Editor
Git
Search
Notes
Terminal
Settings
Shortcuts

Updated: 2026/9/19 21:57:56

PreviousSearch
NextTerminal

#Notes

Notes are plain markdown files in each workspace's .fold/notes/ folder. They are listed by the Notes tool pane — the dock's third tool, ⌘⇧L — and open as document panes like any other file. They never reach the repository: Fold keeps .fold/ out of git for you (the toggle is in Settings).

#Writing

  • ⌘⇧N creates a note in the focused workspace. Notes sort into folders inside the panel, carry tags (#tag in the text becomes a chip; the panel filters by them) and a colour.
  • A note saves itself — half a second after you stop typing, and whenever its pane closes or tucks, the workspace changes, or Fold quits. It never shows a dirty mark and never asks.
  • The note renders as you type: every line is set — headings sized, lists and callouts drawn, tables laid out, checkboxes clickable — except the one the caret is on, which shows its markdown. ⌘⇧M switches the whole note between live and source.
  • A toolbar on the pane carries the formatting tools; each has a key (see Shortcuts).
  • [[wiki-links]] link notes to each other; typing [[ completes note titles, and renaming a note rewrites the links to it.
  • A note can be locked against edits from its pane header.

#Everywhere notes

A second set of notes belongs to no workspace — a folder you pick in Settings, listed under Everywhere in every workspace's notes panel.

#Promoting a note

When a note grows into documentation, promote it: the card's menu moves the file into the repository, at a path you choose, where it becomes an ordinary tracked file.