A (neo)vim plugin for Neuron
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Noah Pederson f78da12270 Move ftdetect to ftplugin and rename script 2 months ago
autoload WIP: fix for neuron v2 query format 3 months ago
doc Tidy up, add in tag search. 6 months ago
ftplugin Move ftdetect to ftplugin and rename script 2 months ago
plugin Define neuron_dir so that it is available for nix installs 5 months ago
test Remove rib references. 6 months ago
LICENSE initial commit 11 months ago
README.md Note nix installation option in README.md 5 months ago
screenshot.png replace screenshot. 7 months ago



Manage your Zettelkasten with the help of neuron in {n}vim.

(This is an actively maintaned fork of ihsanturk/neuron.vim that works with newer versions of neuron and changes basically everything, with extra features, commands and different options.)



  • neuron
  • fzf
  • ag if you intend to use the content search command.


Using vim-plug

Plug 'junegunn/fzf.vim'
Plug 'fiatjaf/neuron.vim'

Using home-manager

There are several ways to manage {n}vim plugins with home-manager. The current release has been tested with the programs.neovim module (tracking nixpkgs-unstable) like so:

  programs.neovim = {
    enable = true;
    plugins = with pkgs.vimPlugins; [
      # ...
  # ...


  1. Open a zettel with vim or nvim. On nvim it should
    • show a virtual floating text on the first line saying how many backlinks it has;
    • show a virtual title for each linked zettel in the body.

Most operations are executed in normal mode

  1. gzZ shows a list of backlinks. Selecting one will navigate to it.
  2. gzz shows a list of all zettels, you can search their titles. Selecting one will navigate to it.
  3. Type gzi to show the same gzz list. Selecting one will insert a link to it right in front of the your cursor. gzI instead will insert a folgezettel link ([[[...]]]). You can also select a zettel from insert mode with <c-x><c-u> or <c-x><c-y> and then insert a normal link or a folgezettel link respectively.
  4. If you put your cursor on top of a link to another zettel and press gzo you'll navigate to that.
  5. gzl inserts a link to the previous zettel you visited.
    • gzL will do the same but with a folgezettel.
  6. gzu goes back after editing another zettel type.
    • gzu repeatedly will cycle between the two last visited zettels.
  7. gzU goes back multiple times in the history of visited zettels (and gzP will go forward).
  8. gzn creates a new blank zettel
  9. gzN creates a new zettel using the current word under the cursor as its title.
    • if you're in visual selection mode gzN will instead use the selected text (only the first line if there are more than one selected). This will replace the selected text or current word with a link to the newly-created zettel.
  10. gzs works like gzz, but instead it searches the content of the zettels, not only the title. For this it calls the external command ag.
  11. gzt will allow you to insert new tags or gzT will show you a list of existing tags to then insert.


  • neuron.vim uses a custom function to generate ids for new zettels that it creates, bypassing neuron new completely. By default it generates a random hex string of 8 characters. You can hook into the process by defining a function g:CustomNeuronIDGenerator in your .vimrc that takes an optional title argument. For example:

    To make it use the title as kebab-cased ID (when using gzN):

    func! g:CustomNeuronIDGenerator(title)
        return substitute(a:title, " ", "-", "g")

    If g:CustomNeuronIDGenerator is not defined in your .vimrc or returns an empty string, neuron.vim will fall back to generating random IDs.