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 search
  • Ctrl/⌘+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 first
  • Ctrl/⌘+Shift+O — open a Markdown file outside any library (see organization)
  • Ctrl/⌘+N — new note
  • Ctrl/⌘+Shift+N — new list note
  • Ctrl/⌘+Shift+A — new voice note
  • Ctrl/⌘+T — new todo
  • Ctrl+Q — quick note (⌃Q on a Mac, where ⌘Q quits)
  • 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/⌘+V still pastes the plain text
  • Ctrl/⌘+Shift+J — today’s journal entry, made first when there is none
  • Ctrl/⌘+Shift+Page Up / Page Down — the journal entry before / after the one on screen
  • Ctrl/⌘+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 sidebar
  • Ctrl/⌘+W — close the note on screen (its tab)
  • Ctrl+Tab / Ctrl+Shift+Tab — next / previous open note (⌃Tab / ⌃⇧Tab on a Mac too, where ⌘Tab switches apps)
  • Ctrl/⌘+\ — split the window right with the note on screen
  • Ctrl/⌘+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 note
  • F11 — Zen mode: the note and nothing else; Esc or F11 again leaves it (see editing); ⌃⌘F on a Mac, where F11 shows the desktop
  • F5 — present the slides note on screen, Alt+F5 its presenter view (see slide notes); on a flashcard deck, study it (see flashcards)
  • While studying: Space shows the answer, then grades Good; 1–4 grade Again, Hard, Good, Easy; Ctrl/⌘+Z takes the last grade back; Esc ends 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/⌘+0 back to its normal size; zoom in also runs on Ctrl/⌘ 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, and Ctrl+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 — underline
  • Ctrl/⌘+Shift+S — strikethrough, Ctrl/⌘+Shift+E — code block
  • Ctrl/⌘+K — link, Ctrl/⌘+Shift+H — heading level
  • Ctrl/⌘+Shift+L — bulleted list, Ctrl/⌘+Shift+D — numbered list
  • Ctrl/⌘+Shift+Q — quote
  • Ctrl/⌘+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 line Ctrl+← goes to the end of the line above, and at the end of a line Ctrl+→ to the head of the line below (past its indentation and any list marker)
  • Ctrl+Shift+← / Ctrl+Shift+→ — select a word
  • Home / End — start and end of the line, Shift to select; Home stops 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 for Ctrl+← / Ctrl+→ alike
  • Ctrl+Home / Ctrl+End — start and end of the note
  • Tab / 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 line
  • PageUp / PageDown — scroll a page, keeping a line of the last one
  • Home / End, with Ctrl or 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 / End and PageUp / PageDown jump
  • Enter — 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 tiles
  • F2 — 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 — find
  • Ctrl/⌘+Alt+F, or classic Ctrl+H on non-mac desktop — replace
  • Esc — close the find bar
  • PageUp / 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 (F5 presents 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+P away 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, and Esc closes 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.

Edit this page on GitHub