Skip to content

Keyboard shortcuts

Press ⌘⇧/ (that's ⌘?) in the app for the complete list. It's generated from the same table the key handler reads, so it can't fall out of step with what the keys actually do.

The keyboard shortcuts overlay, four columns of bindings

This page covers the same ground for reading away from the app. Where the two disagree, believe the app: shortcuts are remappable, and a new one can land in a release before this page catches up.

Worth memorising first

KeysWhat it does
⌘KCommand palette. Everything is in here
⌘NNew note, asking for the title and optionally a folder
⌘⇧FSearch note contents
⌘ECycle edit / split / preview
⌘,Settings, including remapping any of these
⌘⇧/This list, in the app

Notes

KeysWhat it does
⌘NNew note
⌘⇧DNew folder
⌘SSave now
⌘OOpen a file in its own window
⌘⇧OOpen a folder as a vault
⌘⇧PPin or unpin the note
⌘⌫Move the note to the Trash
⌘⇧RRename the note's file
⌘⇧MMove the note to a folder
⌘RReveal in Finder
⌘⇧CCopy the file path
⌘WClose the note
Duplicate the note (no chord: see below)
Browse the note's versions (no chord)

View

KeysWhat it does
⌘ECycle edit / split / preview
⌘⇧EToggle rich markdown in the editor
⌃1Sidebar + list + editor
⌃2List + editor
⌃3Editor only
⌘\Cycle layout
⌘⇧TToggle light / dark
Edit / split / preview view directly (no chord: ⌘E cycles, and :e :sp :view set)
KeysWhat it does
⌘K or ⌘PCommand palette
⌘⇧FSearch note contents
⌘1Focus the sidebar
⌘2Focus the note list
⌘3Focus the editor
⌃hFocus the pane to the left
⌃lFocus the pane to the right

App

KeysWhat it does
⌘⇧NNew window
⌘⇧WClose the window
⌘,Settings
⌘⇧/ or ⌘⇧?Keyboard shortcuts
Check for updates (no chord)
Install the command line tool (no chord)

Editing

These belong to the editor rather than to the app, so they only fire with the editor focused and they can't be remapped in Settings.

KeysWhat it does
⌘BBold
⌘IItalic
⌘⇧KInsert link

In the editor

KeysWhat it does
[[Link to a note, completing on its title
gfFollow the link under the cursor
-clickFollow a link. A plain click still places the cursor
j kMove by visual line, so wrapped prose behaves

In preview

KeysScrolls
j kA line
⌃d ⌃uHalf a screen
⌃f ⌃bA screen

In the note list

KeyWhat it does
j kDown, up
gg GFirst, last
ddMove to the Trash
pPin or unpin
nNew note
/Jump to the search box
lOpen the note and focus the editor
oOpen it and start in insert mode
EscClear the selection, then the search

In the editor

<Space> is the vim leader. The full leader table and every ex command are on the Vim page.

<Space>f  palette      <Space>e  edit view      <Space>o  open file
<Space>/  search       <Space>v  split view     <Space>t  toggle theme
<Space>n  new note     <Space>p  preview view   <Space>m  pin / unpin
<Space>N  new folder   <Space>1 2 3  layouts    <Space>b  backlinks
<Space>s  save         <Space>z  cycle layout   <Space>*  bold
<Space>d  trash                                 <Space>i  italic
                                                <Space>k  insert link

Two shortcuts that don't exist, and why

Duplicate has no chord. The obvious one is ⌘D, and the editor already uses that to add a cursor at the next occurrence of your selection. Duplicate lives in the menu, the palette and the right-click menu instead.

Browse Versions has no chord. It only applies to a note in a synced vault, which is too narrow to earn a global chord. It's in the File menu and the palette.

Note

⌃h stops working while you're in vim's insert mode, where it has to stay backspace. ⌘1 to ⌘3 reach the panes with no such exception.

Remapping

Settings → Keybindings, ⌘,. The recorder captures a real key event, so what you press is what gets bound, and it refuses to shadow a command that already owns that chord.

Vim's own bindings and the note list's j/k keys aren't in that list: they belong to the editor and the list rather than to the global handler. See Settings.

Halcyon is a markdown notes app for macOS.