kiwi.nvim
A minimal, markdown-only wiki plugin for Neovim, stripped down from VimWiki for note-taking and documentation.
What is kiwi.nvim?
kiwi.nvim is a stripped-down wiki plugin for Neovim designed as a minimal alternative to VimWiki. It enables users to create and manage interconnected markdown notes, to-do lists, and documentation directly within Neovim, focusing on essential features without unnecessary complexity. The plugin simplifies knowledge organization by using pure markdown syntax and manual link creation, avoiding the bloat of more feature-rich wiki solutions.
Neovim users who need a lightweight, markdown-based wiki for note-taking, documentation, or blog drafting without the overhead of full-featured plugins. It's ideal for developers, writers, or researchers who prefer minimal tooling and manual control over their workflow.
Developers choose kiwi.nvim for its simplicity and focus on core wiki functionality, offering a faster, more configurable experience compared to VimWiki. Its unique selling point is a barebones design that avoids autosave, multiple syntaxes, and built-in highlighting, allowing users to extend it only as needed with Treesitter or custom keymaps.
Overview
A stripped down VimWiki for Neovim
Use Cases
Best For
- Creating personal knowledge bases in Neovim
- Writing and organizing markdown documentation
- Managing simple to-do lists within a wiki structure
- Drafting blog posts for static site generators like Hugo or Astro
- Users who prefer manual saves and native Vim navigation over automated features
- Neovim enthusiasts seeking a minimal alternative to VimWiki
Not Ideal For
- Users needing automatic syntax highlighting and autosave without additional setup
- Projects requiring support for multiple markup languages beyond markdown
- Teams that rely on advanced wiki features like diary entries or cloud synchronization
Pros & Cons
Pros
Uses exclusively markdown syntax, eliminating the complexity of multiple markup languages and ensuring consistency across notes, as stated in the README comparison with VimWiki.
Allows creating wiki links by pressing Enter on selected text, visually converting phrases into formatted markdown links, demonstrated in the README with examples like 'Project Gutenberg'.
Provides only essential bindings like <Enter> and <Tab>, encouraging the use of native Vim motions and keeping the plugin lightweight, as highlighted in the key bindings section.
Supports setting up separate wikis for different purposes with custom paths via setup options, shown in the usage examples for work and personal wikis.
Cons
Requires users to manually install Treesitter plugins for markdown and markdown-inline to enable syntax highlighting, adding an extra step to setup, as admitted in the README comparison table.
Omits autosave and automatic link navigation, relying on manual saves and native Vim commands like <C-o>, which might be less convenient for users accustomed to automated workflows.
As a minimal plugin, it offers only core features, so users needing advanced capabilities like export tools or extensive customization must rely on additional configurations or external plugins.
Open Source Alternative To
kiwi.nvim is an open-source alternative to the following products:
Frequently Asked Questions
Related Projects
neorgModernity meets insane extensibility. The future of organizing your life in Neovim.
orgmodeOrgmode clone written in Lua for Neovim 0.11.0+.
obsidian.nvimObsidian 🤝 Neovim (actively maintained version)
telekasten.nvimA Neovim (lua) plugin for working with a markdown zettelkasten / wiki and mixing it with a journal, based on telescope.nvim
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.