Docs

Vim mode

Vim motions in the lists and full modal editing in the editor, if that's your way.

If you live in vim, Consistent Notes can meet you there — in the lists, in the editor, or both. Both live in Settings → General → Vim Mode and both are off by default.

Vim motions in the lists

With Vim motions in tabs on, the Notes and ToDos lists respond to the shortcuts below. Works everywhere the arrow keys work — which, if you enable hardcore mode (below), is nowhere: the point is to force the habit.

Notes list

ShortcutAction
Open today’s entry
jMove down the list
kMove up the list
g gTop of list
GStart of month
oOpen the selected day
Open the selected day
Move up the list
Move down the list
NGo to Notes List
YGo to Year View
TGo to ToDos
,Settings
FSearch every entry
Hold Shortcuts overlay

ToDos list

ShortcutAction
Open today’s entry
jMove down the list
kMove up the list
g gFirst todo
GLast todo
oOpen the most recent entry for a todo
Open the most recent entry for a todo
OOpen the original entry
Toggle the selected todo
Move up the list
Move down the list
NGo to Notes List
YGo to Year View
TGo to ToDos
,Settings
Hold Shortcuts overlay

Vim mode in the editor

With Vim mode in editor on, the editor is fully modal. You start in Normal mode, where letters are commands; i a A o O enter Insert mode to type, v V select in visual modes, and / finds. returns to Normal mode, ? shows this whole reference in place. Operators take counts and text objects, so 3dd, 2w, and ci" all work.

Entering modes

ShortcutAction
iInsert mode
aAppend (insert after cursor)
AAppend at end of line
g AAppend at end of visual (wrapped) line
oNew line below
ONew line above
vVisual mode
VVisual line mode
Return to Normal mode
ShortcutAction
hMove left
jMove down
kMove up
lMove right
wNext word
bPrevious word
eEnd of word
WNext WORD (whitespace only)
BPrevious WORD
EEnd of WORD
0Start of line
^First non-blank
$End of line
g 0Start of visual (wrapped) line
g ^First non-blank of visual line
g $End of visual (wrapped) line
g jDown one visual line
g kUp one visual line
g gStart of doc
GEnd of doc
{Previous paragraph
}Next paragraph
fFind char forward on line
FFind char backward on line
tTill char forward on line
TTill char backward on line
%Jump to matching bracket
;Repeat last f/t find
,Repeat last f/t find (reverse)

Delete

ShortcutAction
xDelete char
d dDelete line
d wDelete word
d i wDelete inner word
d a wDelete around word
d i [Delete inside brackets
d i Delete inside quotes
d a [Delete around brackets
d a Delete around quotes
d i pDelete inner paragraph
d a pDelete around paragraph
DDelete to end of line

Change

ShortcutAction
c cChange line
c wChange word
c i wChange inner word
c a wChange around word
c i [Change inside brackets
c i Change inside quotes
c a [Change around brackets
c a Change around quotes
c i pChange inner paragraph
c a pChange around paragraph
CChange to end of line
SSubstitute line

Yank

ShortcutAction
y yYank line
y wYank word
y i wYank inner word
y a wYank around word
y i [Yank inside brackets
y i Yank inside quotes
y a [Yank around brackets
y a Yank around quotes
y i pYank inner paragraph
y a pYank around paragraph

Indent and other commands

ShortcutAction
> >Indent line
< <Dedent line
rReplace character
JJoin lines

Paste, undo, and redo

ShortcutAction
pPaste after cursor
PPaste before cursor
uUndo
rRedo

Find

ShortcutAction
/Find
*Search word under cursor forward
#Search word under cursor backward
nNext match
NPrevious match

Scroll

ShortcutAction
z zScroll cursor to center
z tScroll cursor to top
z bScroll cursor to bottom
qClose editor
Close editor
?Show this help

A couple of options tune it:

  • Move up and down by visual lines (on by default) — j/k follow wrapped lines; counts like 5j always use logical lines.
  • Escape sequence — record two keystrokes (classic: jk) that exit Insert mode without reaching for .
  • Show vim indicator — the little mode badge (N / I / VISUAL) in the editor header.

Hardcore mode

Hardcore mode disables arrow-key navigation in the Notes and ToDos lists, filtered from the shortcut hints too. The editor is unaffected — arrows still move the cursor while you’re typing. It exists to build the muscle memory; it does not exist to punish edits.

Hold anywhere to see the shortcuts that apply where you are, vim or not.