Learn Practice Daily golf Reference

VimNinja for ObsidianComing soon

Learn Vim where you write.

You turned on Vim key bindings, and now i types and Esc stops. VimNinja is the rest, inside Obsidian: 82 short lessons, a two-minute daily review, Vim golf, and practice on a copy of your own notes, in a tab that looks like the rest of your vault.

Coming to Obsidian’s community plugins. Start the course now, connect the plugin when it’s out, and everything you’ve done comes with you.

Obsidian with today’s daily note on the left, VimNinja’s card in it saying 3 commands are fading, and VimNinja’s tab on the right with a review round under way
VimNinja beside a daily note, in Obsidian’s own theme.

Your notes, with Vim’s keys.

In Obsidian, Practise Vim on this note opens any note as a copy, with every key read back. Here’s a daily note to try it on now.

Try it here

Tidy today’s note

Show the full solutionrx, then 3j and dd, then A, a space and by Friday, and Esc.
You replied to Sam: r then x puts an x in the box2026-11-20.md
1## Today
2- [ ] Reply to Sam about the launch
1- [ ] Book the dentist
2- [x] Water the plants
3- [ ] Book the dentist
4- [ ] Draft the newsletter intro
NORMALLoading the editor…0.0sLn 2, Col :4
Open this text in the playground

This editor needs a keyboard. Read on, and play it at your computer.

What it adds to Obsidian

Real captures of the plugin, in Obsidian 1.15.

A VimNinja lesson in an Obsidian tab: Fill the gaps, the editor reading back fl as Move to the next l

A course in a tab

82 short lessons, from your first keystroke to macros, a few minutes each. Where Obsidian’s Vim works differently, the lesson says so.

A newsletter note in Obsidian beside VimNinja’s copy of it, where cw has changed December to January

Practice on your own notes

Any note, or just the lines you selected, opens as a copy. Change it, undo it, try again. The note itself never changes.

Obsidian’s side pane showing VimNinja’s today: 3 commands are fading, the next lesson and today’s golf hole

Two minutes a day keeps it

Each command comes back just as you’d start to forget it. The status bar counts what’s due; a vimninja block in your daily note and the side pane show it too.

An Obsidian notice in the corner: 3 commands are fading, with a Review now button

A nudge, when it’s time

At a time you pick, or when you come back to Obsidian. At most one a day, never once today’s review is done.

The keys people add first, without a config file.

Turn one on and it works in every note. Each one shows the .obsidian.vimrc line it stands for, so you learn it rather than hide it, and each comes off the moment you turn it off.

.obsidian.vimrc1 of 4 on
" Leave Insert mode with jk imap jk <Esc> " j and k by the lines you see nmap j gjnmap k gk " y and p with the system clipboard set clipboard=unnamed " Vim’s keys for links, tabs and folds exmap followlink obcommand editor:follow-linknmap gd :followlink<CR>exmap nexttab obcommand workspace:next-tabnmap gt :nexttab<CR>exmap prevtab obcommand workspace:previous-tabnmap gT :prevtab<CR>exmap togglefold obcommand editor:toggle-foldnmap za :togglefold<CR>exmap foldall obcommand editor:fold-allnmap zM :foldall<CR>exmap unfoldall obcommand editor:unfold-allnmap zR :unfoldall<CR>

You don’t write this file: VimNinja sets the same keys in Obsidian’s Vim for you. It’s here so you know what each one is.

It wears your theme.

Your colours and your interface font, light or dark, a community theme too. Nothing to set up. The code editor keeps its own colours, as a code block does.

VimNinja’s course in Obsidian’s dark theme, its purple accent VimNinja’s course in Obsidian’s light theme with a teal accent, the Continue button and the current lesson in teal

Everything is a command away.

Every part of it is in Obsidian’s command palette, ready for a hotkey of your own. Type to look.

  • VimNinja: Open VimNinja’s tab, where you left it
  • VimNinja: Show today in the side pane Your streak, what’s fading, the next lesson, today’s hole
  • VimNinja: Today’s review (the Daily 5) Two minutes on the commands that are fading
  • VimNinja: Practise Drills for every command, on real text
  • VimNinja: Today’s golf hole One Vim puzzle a day, fewest keystrokes wins
  • VimNinja: Next lesson Straight to where the course goes next
  • VimNinja: Practise Vim on this note The note, or the lines you selected, as a copy to practise on
  • VimNinja: Turn Vim key bindings on or off in notes Obsidian’s own setting, one command away
  • VimNinja: Connect your account Optional: sync with the course on vimninja.com

Vim in Obsidian: what to know

Obsidian’s Vim is CodeMirror’s copy of Vim. It does most of Vim well, and a few things its own way. The lessons note each one, and so does the plugin.

The full guide to Vim in Obsidian →

One course, wherever you practise.

Connect the plugin to your vimninja.com account and they become one: your results and reviews sync both ways, your plan sets the reminder, and Pro opens in Obsidian too. It’s optional, and until you connect, nothing leaves Obsidian.

  1. Start here, now. The course, the daily review and golf, free, in your browser.
  2. Add the plugin when it’s out. From Obsidian’s community plugins.
  3. Connect, once. A short code you approve here, and your progress is in Obsidian.

Your vault stays yours.

Connected, it sends your practice to your account (your results, your reviews, the exercises you finish) and nothing else from Obsidian: never a note, never a file’s name. The privacy policy

Questions

Something else? Ask us. We read everything.

When is it out?

Soon. It’s built and tested, and goes to Obsidian’s community plugins next. Start the course here now: when the plugin is out, connect it to your account and everything you’ve done comes with you.

Is it free?

Yes. The plugin is free, with the free lessons, the daily review, practice drills and golf. Pro, on vimninja.com, opens every lesson’s exercises and every drill, there and in the plugin once your account is connected.

Do I need Vim key bindings turned on?

Not to learn: the lessons run in VimNinja’s own Vim. To use what you learn in your notes, yes, and VimNinja’s settings turn Obsidian’s Vim key bindings on for you.

Will it change my notes?

No. Your note works on a copy, and nothing is written into your vault except the plugin’s own settings. The Vim keys for Obsidian are off until you turn each one on, and come off the moment you turn it off.

Does it work with my theme?

Yes. Its tab takes your theme’s colours and interface font, light or dark, community themes too. You can switch to VimNinja’s own colours in its settings.

Does it work on my phone?

Not yet: it’s for Obsidian on a computer, where there’s a keyboard to learn Vim on. The course on vimninja.com works on a phone.

I already use the browser extension. Do I need both?

No. They do the same job in different places: the extension in your browser’s toolbar, the plugin in Obsidian. Connect both to your account and they share your progress.

Is it open source?

No. The plugin is published as built files, its source isn’t public, and it passes Obsidian’s own review rules. What it does with your data is in its README and our privacy policy: nothing leaves Obsidian unless you connect an account.

Start learning now.
Bring it into Obsidian when it lands.

The plugin will be free. Desktop, Obsidian 1.13 or later.