docs / keys-and-commands

Keys and commands.

Every key and every command in Paperkites. :keys shows the full map from anywhere in the app.

Paperkites has three modes: INSERT (typing), NORMAL (moving) and COMMAND (: and /). Inside a note, press esc to reach NORMAL before : or /, or they type into the note.

Anywhere

Key	Does
`⌘K`	summon: notes, fragments, tags, commands
`⌘\`	the sidebar
`:`	command line (`Tab` completes)
`/`	search the text of every note
`⌃o` / `⌃i`	back / forward
`⌃h` / `⌃l`	back / forward, outside typing (there ⌃h is backspace)
`gh`	home
`gp`	outside a note: the people list in summon

Capture box

Key	Does
`⏎`	newline; never saves
`⌘↩`	save as a fragment
`⌘E`	open as a note
`esc`	to the list; the draft stays

Lists

Key	Does
`j` / `k`	move
`gg` / `G`	the ends
`[d` / `]d`	previous / next day
`⏎`	open
`x`	pin or unpin
`i`	the capture box

In a note

Key	Does
`gd`	follow the link, tag or person under the caret
`K`	peek at it
`gt`	open the tag under the caret
`gp`	open the person under the caret
`gr`	the graph
`⌘B` · `⌘I` · `⌘K`	with text selected: bold · italic · link
`#` · `[[` · `@`	a tag · a link · a person, each with completion
`@date` · `@date:tom` · `@date:yes`	today · tomorrow · yesterday, as a date

The rest is vim.

Todos

Key	Does
`⌘↩`	open ↔ done
`⌘⇧↩`	pick a state

`@` completion

Key	Does
`⏎`	insert the mention
`⇥`	insert the name and the mention
`⌃n`	a new person

Summon (⌘K)

Key	Does
`↑` `↓` / `⌃n` `⌃p`	move
`⏎`	open
`#` first	tags only
`@` first	people only
`⌃r`	rename the tag or username everywhere

Search results

Key	Does
`n` / `N`	next / previous match
`⏎`	open at the match

Key	Does
`j` / `k`	move
`l` / `h`	open / close a tag
`⏎`	open the row
`esc`	back to the page
`⌘\`	hide it

Split

Key	Does
`⌃w v`	split
`⌃w w`	switch
`⌃w q`	close
`⌃w o`	only this one

Graph

Key	Does
`h` `j` `k` `l`	pan
`+` / `-`	zoom
`0`	fit
`n` / `N`	step through notes, most linked first
`⏎`	open
`t`	hide or show tags

Settings

Key	Does
`j` / `k`	pick a row
`h` / `l` (or `←` `→`)	change it
`0`	reset it
`⏎`	run a row's button
`esc`	show these keys; again to go back

A locked note's password

Key	Does
`⏎`	unlock (or lock, or change the password)
`esc`	leave it locked; from `:lock` or `:passwd`, back to the note
`Tab`	the next field, then show, which shows the password

Commands

Type :, then the command, and press ⏎. Tab completes.

Command	Does
`:home`	the capture box and the list
`:new [title]`	a new note
`:daily`	today's note (`YYYY-MM-DD`), made if missing
`:tag <name>`	a tag's page
`:notes [--asc\|--desc]`	every note, newest first or by title
`:keys`	the full keymap, built in, whatever is in your vault
`:settings`	appearance, themes, reading, writing, vault
`:vim on` / `:vim off`	vim keys, the same setting as in `:settings`
`:theme light\|dark\|system`	the appearance
`:theme reload`	read the theme files again
`:theme ground <pattern>`	try a dot pattern: `plain`, `dotted` or `dotted-edges`
`:vault [folder]`	show the vault, or switch to another folder
`:undo`	undo the last tag or username rename
`:delete`	move the note you're in to the trash
`:trash`	trashed notes; `⏎` puts one back where it lived
`:trash empty`	delete everything in the trash for good
`:pin` · `:unpin`	pin a note to the top of the lists, or unpin it
`:pinned`	pinned notes and fragments
`:format`	tidy this note's markdown: tables, lists, blank lines; never the words
`:reload` · `:w`	after an edit elsewhere: take the file's version · write yours over it
`:lock`	lock this note with a password of its own; on an open locked note, lock it now (see Locked notes)
`:unlock`	put the caret in a locked note's password field
`:lockall`	lock every open locked note
`:passwd`	a new password for an open locked note
`:unlocknote`	take an open note's lock off: plain files again
`:info`	a note's words, reading time, file and links
`:orphans`	notes with no links in or out
`:graph`	the note graph
`:vsplit` · `:q` · `:only`	split · close this column · keep only this one

Aliases: :set (settings), :vs and :sp (vsplit), :close (q), :on (only), :rm (delete).