Back to guides
GuideChecked November 20264 min read

Vim mode

Vim mode in Ferrite is optional and off by default. Enable it in Settings, then use Normal, Insert, and Visual.

Vim mode has been in Ferrite since v0.2.7. It is optional. It stays off until you turn it on. This page describes the switch and the commands the FAQ actually lists, for Ferrite 0.3.1. It is not a full keymap.

Turn it on

Open Settings, then Editor, and enable Vim mode. The v0.2.7 notes say a mode indicator in the status bar shows Normal, Insert, or Visual once it is on. Existing Ferrite shortcuts keep working alongside the Vim bindings.

The rest of the keyboard, outside Vim, is the shortcuts page.

The modes

Normal mode is for motions and the line edits below. Insert mode is ordinary typing. Escape returns you to Normal. Visual mode selects text: v for characters, V for lines.

The FAQ describes these essential commands:

  • hjkl to move
  • dd to delete a line
  • yy to yank
  • p to paste
  • / to search
  • v and V to select

That is the set this guide will claim. Commands that are not in that list are not documented here, even if a Vim user would expect them.

What it does not change

Vim mode does not add a plugin store, a graph, or sync. It is an editing option in the raw editor. Notes are still the files in the folder you opened, which is covered in your files stay on disk. Linked notes are a separate feature, in wikilinks.

If you are comparing Ferrite with an editor whose Vim support you already rely on, start with Ferrite vs Obsidian. That page marks Vim on the other side as not confirmed, rather than guessing.

The download is on the download page. A wider feature list is on features.

Questions