github github
stars 85
issues 2
subscribers 2
forks 1



11 days ago

kiwi.nvim 🥝



kiwi.nvim is a stripped down version of Vimwiki for Neovim.

VimWiki kiwi.nvim
Multiple syntaxes Sticks to markdown
Syntax highlights included User can install Treesitter plugins markdown and markdown-inline if required
Keymaps like Backspace for autosave Stick to manual saves and <C-o> to move back

With kiwi.nvim, you can:

  • Organize notes and ideas
  • Manage to-do lists
  • Write documentation
  • Maintain a diary
  • Write blog posts to Hugo and Astro

To do a quick start, press <Leader>ww (default is \ww) to go to your index wiki file. By default, it is located in ~/wiki/ To register a different path for the wiki, you can specify the path inside the setup function if required

Feed it with the following example:

# My knowledge base
    - Tasks -- things to be done _yesterday_!!!
    - Project Gutenberg -- good books are power.
    - Scratchpad -- various temporary stuff.

Place your cursor on Tasks and press Enter to create a link. Once pressed, Tasks will become [Tasks](./ and open it. Edit the file, save it. To go back, you can press <C-o> to move to the previous file. Backspace is not mapped to go back since we already have vim keybindings to move back.

A markdown link can be constructed from more than one word. Just visually select the words to be linked and press Enter. Try it, with Project Gutenberg. The result should look something like:

# My knowledge base
    - [Tasks](./ -- things to be done _yesterday_!!!
    - [Project Gutenberg](./ -- good books are power.
    - Scratchpad -- various temporary stuff.



kiwi.nvim has been tested on Neovim >= 0.7. It will likely work on older versions but will not be officially supported.


kiwi.nvim has dependency on nvim-lua/plenary.nvim.

Installation using Vim-Plug

Add the following to the plugin-configuration in your vimrc:

Plug 'serenevoid/kiwi.nvim'

Then run :PlugInstall.

Installation using Packer

use {
  requires = { {'nvim-lua/plenary.nvim'} }

Installation using Lazy

-- init.lua:
    'serenevoid/kiwi.nvim', dependencies = { 'nvim-lua/plenary.nvim' }

-- plugins/kiwi.lua:
return {
    'serenevoid/kiwi.nvim', dependencies = { 'nvim-lua/plenary.nvim' }


For Lazy users,

    dependencies = {
    opts = {
            name = "work",
            path = "/home/username/wiki_1"
            name = "personal",
            path = "/home/username/wiki_2"
    keys = {
        { "<leader>ww", ":lua require(\"kiwi\").open_wiki_index()<cr>", desc = "Open Wiki index" },
        { "<leader>wd", ":lua require(\"kiwi\").open_diary_index()<cr>", desc = "Open Diary index" },
        { "<leader>wn", ":lua require(\"kiwi\").open_diary_new()<cr>", desc = "Open today's Diary" },
        { "<leader>t", ":lua require(\"kiwi\").todo.toggle()<cr>", desc = "Toggle Markdown Task" }
    lazy = true

For others,

-- Setup Custom wiki path if required
    name = "work",
    path = "C:\\Users\\username\\personal-wiki" -- For Windows users
    name = "personal",
    path = "/home/username/personal-wiki"

-- Use default path (i.e. ~/wiki/)
local kiwi = require('kiwi')

-- Necessary keybindings
vim.keymap.set('n', '<leader>ww', kiwi.open_wiki_index, {})
vim.keymap.set('n', '<leader>wd', kiwi.open_diary_index, {})
vim.keymap.set('n', '<leader>wn', kiwi.open_diary_new, {})
vim.keymap.set('n', '<leader-x>', kiwi.todo.toggle, {})


  • Diary Index is auto-generated. Please avoid editing Diary index file.
  • When opening a new Diary page, a prompt will ask you for required offest in date. Provide the number of days to be offset from today's date Use positive values for future Diaries and negative for past

Key bindings

Basic key bindings

  • <Enter> -- Follow/Create wiki link.
  • <Tab> -- Find next wiki link.
  • <Control-Space> -- Toggle TODO list

Helping kiwi.nvim

This is a new project which aims to be a minimal wiki plugin which is very barebones and doesn't add features which a lot people doesn't use now. You can help by raising issues and bug fixes to help develop this project for the neovim community.

Stargazers over time

Stargazers over time