Vimwiki is a personal wiki for Vim – interlinked, plain text files written in a markup language
With Vimwiki you can
- organize notes and ideas and quickly create links between them
- manage todo-lists
- write a diary
Features
- three markup syntaxes supported: Vimwiki's own syntax, Markdown, MediaWiki
- export everything to HTML
- link to other wiki pages and external files
- search through all wiki pages
- outline notes and tasks in indented lists
- quickly manipulate numbered and bulleted lists
- tag wiki pages or arbitrary places and quickly jump to tags
- auto-formatted tables
Screenshots
Quickstart
Press <Leader>ww
(this is usually \ww
) to go to your index
page. By default it is located in ~/vimwiki/index.wiki
.
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. Press Enter again to
open it. Edit the new page, save it, and press Backspace to jump back to your
index.
A Vimwiki 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.
See :h vimwiki
for the full documentation.
Basic markup (default syntax)
= Header1 =
== Header2 ==
=== Header3 ===
*bold text*
_italic text_
[[wiki link]]
[[wiki link|description]]
* bullet list item 1
* bullet list item 2
a) numbered list item 1
b) numbered list item 2
{{{python
def greet(s):
print("Hello, " + s)
}}}
| a table | |
|---------|--|
| | |
For other syntax elements, see :h vimwiki-syntax
Key bindings
-
<Leader>ww
– Open the default wiki index file -
<Leader>ws
– Select and open wiki index file -
<Enter>
– Follow/Create wiki link -
<Backspace>
– Go back to parent(previous) wiki link -
<Tab>
– Find next wiki link -
<Shift-Tab>
– Find previous wiki link
For more keys, see :h vimwiki-mappings
Commands
-
:Vimwiki2HTML
– Convert current wiki page to HTML -
:VimwikiAll2HTML
– Convert all your wiki pages to HTML
For more, see :h vimwiki-commands
Installation
Use the Plugin-manager of your choice to install vimwiki.
Prerequisites
Make sure you have these settings in your vimrc file:
set nocompatible
filetype plugin on
syntax on
Without them Vimwiki will not work properly.
Vim-Plug
Installation usingAdd the following to the plugin-configuration in your vimrc:
Plug 'vimwiki/vimwiki'
Then run :PlugInstall
.
Pathogen
Installation usingcd ~/.vim
mkdir bundle
cd bundle
git clone https://github.com/vimwiki/vimwiki.git
Alternatively, download the latest version (zip, tar) and extract it into ~/.vim/bundle/
Then launch Vim, run :Helptags
and then :help vimwiki
to verify it was installed.