Shortcuts
Keyboard (desktop)
App-level accelerators, as Niman ships them. Settings → Keyboard
shortcuts lists them and lets you change them. On a Mac — and on an iPad
or iPhone with a hardware keyboard — ⌘ stands for
Ctrl and the keys read as the system writes them (⇧⌘N); where ⌘
would take a key macOS keeps, the Mac has a key of its own, named below.
The Mac’s menu bar holds the same commands, each with its key:
Ctrl/⌘+Shift+P— the command palette: commands and notes in one searchCtrl/⌘+O— go to a note (the palette, on notes alone): by its name, an alias or a word of its title, from two characters; the name you typed in full comes firstCtrl/⌘+Shift+O— open a Markdown file outside any library (see organization)Ctrl/⌘+N— new noteCtrl/⌘+Shift+N— new list noteCtrl/⌘+Shift+A— new voice noteCtrl/⌘+T— new todoCtrl+Q— quick note (⌃Qon a Mac, where⌘Qquits)Ctrl/⌘+Shift+W— capture a web page as a note, the clipboard’s address when it holds one (see web capture)Ctrl/⌘+Shift+V— paste as Markdown: what was copied from a web page goes into the note as Markdown, linked to its page (see web capture);Ctrl/⌘+Vstill pastes the plain textCtrl/⌘+Shift+J— today’s journal entry, made first when there is noneCtrl/⌘+Shift+Page Up/Page Down— the journal entry before / after the one on screenCtrl/⌘+Shift+F— the search sidebar: show it and put the cursor in its field (see search)F4/Shift+F4— the next / previous hit of the search sidebar, opening it in the pane (see search)Ctrl/⌘+B— show or hide the sidebarCtrl/⌘+W— close the note on screen (its tab)Ctrl+Tab/Ctrl+Shift+Tab— next / previous open note (⌃Tab/⌃⇧Tabon a Mac too, where⌘Tabswitches apps)Ctrl/⌘+\— split the window right with the note on screenCtrl/⌘+Shift+B— show or hide the side panel (outline, tags, links, history, the journal’s calendar); on a window too narrow to dock it, it opens over the noteF11— Zen mode: the note and nothing else;EscorF11again leaves it (see editing);⌃⌘Fon a Mac, whereF11shows the desktopF5— present the slides note on screen,Alt+F5its presenter view (see slide notes); on a flashcard deck, study it (see flashcards)- While studying:
Spaceshows the answer, then grades Good;1–4grade Again, Hard, Good, Easy;Ctrl/⌘+Ztakes the last grade back;Escends the session (see flashcards) Ctrl/⌘+Shift+T— typewriter mode on or off: the line being written stays in the middle (see editing)Ctrl/⌘+=/Ctrl/⌘+-— zoom the note’s text in and out,Ctrl/⌘+0back to its normal size; zoom in also runs onCtrl/⌘and the+key however the keyboard types it (its own key on an Italian or German layout,Shift+=on a US one), and both on the numpad’s+and-, while the zoom keys are the shipped ones: the library’s note text size (Settings → Appearance), in the editor and the preview alike; on a phone, pinch the note with two fingers — spread them to zoom in, bring them together to zoom out — or use Zoom in, Zoom out and Reset zoom in the command palette; a laptop’s trackpad pinches the same way, andCtrl+mouse wheel over the note steps it on a desktop. With a book on screen the same keys, pinch, wheel and commands zoom the book’s text instead, the books’ own text size (see organization)Ctrl/⌘+1…7— Files, Todo, Search, Quick note, Settings, Home and Study tabs (on a wide window Settings opens as a floating window; Study opens even while it is hidden from the navigation); on a Mac Settings is⌘,, as in every Mac app
Formatting, in both editors, on the note’s selection:
Ctrl/⌘+B— bold,Ctrl/⌘+I— italic,Ctrl/⌘+U— underlineCtrl/⌘+Shift+S— strikethrough,Ctrl/⌘+Shift+E— code blockCtrl/⌘+K— link,Ctrl/⌘+Shift+H— heading levelCtrl/⌘+Shift+L— bulleted list,Ctrl/⌘+Shift+D— numbered listCtrl/⌘+Shift+Q— quoteCtrl/⌘+M/Ctrl/⌘+Shift+M— indent / outdent (a list item nests under the item above it, see editing)- highlight (
==…==) has no key of its own as shipped: give it one in Settings → Keyboard shortcuts → Formatting
These do exactly what the toolbar’s buttons do, and they are
changeable like the rest (Settings → Keyboard shortcuts →
Formatting). They apply while an editor has the focus, and the app’s
own commands keep off them, so a combination means one thing: Ctrl/⌘+B
is bold inside an editor and the side panel outside one, the one overlap
the two have always shared.
Moving and selecting in the source editor, on Windows and Linux:
Ctrl+←/Ctrl+→— jump a word; at the head of a lineCtrl+←goes to the end of the line above, and at the end of a lineCtrl+→to the head of the line below (past its indentation and any list marker)Ctrl+Shift+←/Ctrl+Shift+→— select a wordHome/End— start and end of the line,Shiftto select;Homestops first where the text starts, past the indentation and any list marker, task box, quote mark or heading hashes, and a second press goes to the very start of the line; with the caret already before the text (among the hashes, in the indentation) a single press goes to the start of the line, never rightwards; in a code block, a math block, HTML or the frontmatter a#,-or>is text, so only the indentation is skipped — there and forCtrl+←/Ctrl+→alikeCtrl+Home/Ctrl+End— start and end of the noteTab/Shift+Tab— indent and outdent the line (a list item nests under the item above it and back, see editing); in a table in live mode, the next and the previous cell instead
Reading a note in the read view (Markdown notes, with the unified engine), which takes the keyboard when you switch to it or click it:
↑/↓— scroll a linePageUp/PageDown— scroll a page, keeping a line of the last oneHome/End, withCtrlor without — start and end of the note
The Files pane — the tree or the grid, whichever view is on — takes the
keyboard when you click a folder’s row or tile, or with Tab. A click on
a note (or Enter on it) opens it and puts the caret in it, ready to
write, on a desktop; a phone’s keyboard follows its own Keyboard on
open setting:
↑/↓— walk the rows;Home/EndandPageUp/PageDownjumpEnter— open the note the cursor is on, or open a folder in the tree; in the grid, a folder’s tile is entered←/→— in the tree, close an open folder or step out to the row that holds it, and open a closed one or step into the rows under it; in the grid, walk the tilesF2— rename the row the cursor is on (in place on Linux and Windows, the dialog on a phone);Delete— delete it- Menu key /
Shift+F10— open the menu of the row the cursor is on, as a right click does Backspace/Alt+Up— in the grid, up one folder
A modified key is left to the app’s own shortcuts: Alt+← / Alt+→ (⌘[
/ ⌘] on a Mac, where ⌥← moves by a word) walk the notes’ history and Ctrl/⌘+Shift+PageUp / PageDown the journal,
even while a row or a tile holds the cursor.
Editor find/replace follows the familiar bindings:
Ctrl/⌘+F— findCtrl/⌘+Alt+F, or classicCtrl+Hon non-mac desktop — replaceEsc— close the find barPageUp/PageDown— move in results
Links: Ctrl+click a link in the source editor to follow it.
Selecting with the mouse: drag over the text, or Shift+click to select
from the caret to the click (a drag after it goes on extending).
Changing a shortcut
On a desktop with the app’s own title bar, the ☰ before the window’s buttons is the menu (#712): every command of the palette, grouped as the palette names them — Note, Editor, View, Library, Journal, Go to — and Help, each with its keys beside it. A command that cannot run now is there, greyed.
In the palette itself, Alt+P pins or unpins the selected command;
pinned ones head it before anything is typed. On a phone the palette
opens with two fingers dragged down, with the ⚡ on the Search tab’s
bar, or from an open note’s ⋮ menu.
Settings → Keyboard shortcuts lists every command, with its keys or with No shortcut, and is where they change. Settings → Commands is the palette’s reference: the same commands, with when each one can run — the palette and the keys offer a command only where it can, so one that needs an open note is not there without one, and one that works on a note’s text (preview, tidy, history) is not there with a picture, a PDF or a book on screen. Nothing changes there: its keys are the ones set in Keyboard shortcuts and follow them, and tapping a key (or Change keys in Keyboard shortcuts) opens that command’s row there.
- Change. Tap a command and press the new combination. While the window is recording it takes every key, Esc and Tab included, so leave with Cancel, or by holding Esc down. A key on its own is refused, because a plain letter is for typing; function keys (F1…F24) may stand alone.
- Conflicts. A combination another command already has is never
taken silently. The screen names that command and asks whether to
move the keys; if you do, that command is left with no shortcut. A
combination shipped on two commands (
F5presents slides and studies a deck) names both, and moving it leaves both without. - Keys the text fields and the editors use. Copy, paste, cut, select all, undo, redo, find, replace and the formatting keys may be taken, after a plain warning: your command takes them there too, outside an editor.
- The Formatting group changes the same way, with its own conflicts: a formatting key collides with another formatting key, not with an app command, since the two apply in different places. A formatting key you moved stops working on its old combination in both editors. A key you give an app command wins over the formatting that has it, inside the editors too — your word is the last one.
- Remove and restore. × removes a command’s shortcut. A command
with none is still one
Ctrl+Shift+Paway in the command palette. ↺ puts back the key Niman ships, and Restore defaults puts back every one.
A key you chose wins everywhere, both editors included: Niman looks for it before the editor hears the key. The keys as shipped are chosen not to collide with the editor’s own.
The shortcuts belong to this device: they are kept in its settings, never in a library, so a library synced to another computer does not bring this keyboard’s keys with it.
Some combinations never reach an app. Win+anything on Windows, and the
ones your Linux desktop keeps for itself, are taken before Niman sees
them. Niman cannot tell which these are, so a shortcut set on one simply
never fires.
The command palette
Ctrl+Shift+P opens one field over whatever is on screen. It searches
the app’s commands and your notes by name at once:
- Names. Commands are named
Group: Verb, such as Editor: Switch to the WYSIWYG editor or Library: Re-index now. A trailing…means the command will ask you something before it acts (Note: Move…). - Keys. A command that has a key shows it beside its name.
- Moving and choosing.
↑/↓move through the list,↵runs the command or opens the note, andEsccloses the palette. The line at its foot says so. - Order. Before you type, it offers the commands you used last and the notes you had open. Once you type, what you used lately still comes first.
- Only what works here. It lists the commands that can run where you are: nothing about the note when none is open, no panes on a phone.
Some commands have no key at all, such as renaming the note on screen or re-indexing the library: the palette is how you reach them.
On a phone the Search tab is the palette: whatever you type lists the matching commands above the notes found, and a tap runs one.
In the file tree, Ctrl+click a note (or middle-click its tab to close
it) to open it in a tab of its own — see
editing.
Launcher quick actions (Android and iOS)
Long-press the app icon for dynamic shortcuts (labels localized, published at startup; on iOS they are the icon’s quick actions):
- Quick note — opens the quick note
- Today’s journal entry — opens today’s journal entry, made first when there is none
- New todo — opens the Todo tab’s add-task dialog
- New note — the Files FAB’s “New note” flow
- New list note — the Files FAB’s “New list note” flow (desktop tray and Linux launcher; Android launchers and iOS show the first four)
- New voice note — the Files FAB’s “New voice note” flow (likewise)
Each shortcut runs the same flow as its in-app button, so the two can never drift. Only the folder differs: the FAB makes its note in the library root, a shortcut where the library’s setting for new notes puts it.
CLI launch flags (desktop)
Desktop builds accept --quick-note, --journal-today, --new-todo,
--new-note, --new-list, --new-voice, routed through the same
handler as the launcher actions — and the tray menu lists the same ones.
The niman command is the package’s: the Arch package and the Linux
tarball’s root launcher put it on PATH, while the AppImage and the
Windows build are run by their own path — see
platforms.
A path opens that file: niman ~/project/README.md opens it the way
Open file does (see
organization). A
relative path is read from where the command was typed.
There is only ever one Niman per session. With Niman already running,
niman <file> or niman --quick-note hands itself to that Niman, which
comes to the front and does it, and the new launch ends without
opening a window. That is also what keeps two processes from holding
one library.