Skip to content

Settings

⌘,, or the gear at the bottom of the sidebar. Two tabs, plus a third on builds that have Sync.

General

Settings, General: theme, editor font size, autosave delay, and the toggles

SettingRangeWhat it does
ThemeLight, darkOverrides your system setting. ⌘⇧T toggles it from anywhere
Editor font size12px to 22pxThe editor and preview. Default 15.5px
Autosave delay250ms to 3000msHow long after you stop typing before Halcyon writes. Default 700ms. ⌘S saves immediately regardless
Vim keybindingsOn / offModal editing in the editor: motions, operators, the Space leader, ex commands
Rich markdownOn / offWhether markdown styles as you type. Off leaves plain markdown, still syntax highlighted
Confirm before deleteOn / offWhether trashing asks first. Deleted notes go to your Trash either way

Turning Vim keybindings off leaves everything else working: the note list keeps its own j/k keys, and every app shortcut is unaffected.

Rich markdown is the same switch as ⌘⇧E, which toggles it for the session. Setting it here is what makes the choice stick.

Keybindings

Settings, Keybindings: every command with its chord, and a recorder

Click a shortcut, then press the keys you want. The recorder captures a real key event, so what you press is what gets bound.

Four rules it enforces:

  • A chord needs at least one modifier. Bare keys belong to whichever pane has focus.
  • Chords the editor already answers are refused. ⌘Z, ⌘F, ⌘D and the rest, because both would fire and you'd get two actions from one keystroke.
  • A chord another command owns is refused. You get told which command has it rather than silently losing one.
  • Vim's bindings and the note list's j/k aren't here. Those belong to the editor and the list, not to the global handler.

Rebound commands show a reset link, and Reset all at the top appears once anything is customised, with a count.

⌘B, ⌘I and ⌘⇧K draw no section here at all: those belong to the editor rather than to the app, so this editor can't remap them.

Sync

Only on builds that include it, and only shown when there's something to say. See Turning Sync on.

RowWhat it does
Your accountShows the plan state, with Sign out
Sync this vaultTurns sync on or off for the vault this window has open
Open remote vaultAttaches a vault synced from another Mac
Recovery codeCreates one, or rotates the one you have

Note

If Settings shows no Sync tab, you have a build without Sync rather than a broken one. Not every build includes it.

Where settings are stored

In the app's own storage, not in your vault. Your notes folder holds notes and nothing else, which is what makes it safe to point Halcyon at a git repository or a folder you share by other means.

See Where your files live.

Halcyon is a markdown notes app for macOS.