README.md

Introduction

This is a Vim plugin for writing and maintaining a personal wiki in Markdown syntax. It is based on vimwiki, but written mostly from scratch.

This README file contains basic information on how to get started, as well as a list of available features. For complete documentation, please confer the full documentation.

Table of contents

• Quick Start
• Features
• TODO
• Acknowledgements

Quick Start

Installation

If you use vim-plug, then add the following line to your vimrc file:

Plug 'lervag/wiki.vim'

Or use some other plugin manager:

• vundle
• neobundle
• pathogen

Usage

This outlines the basic steps necessary to get started:

1. Create a wiki directory where the wiki files should be stored, for instance ~/documents/wiki.

2. Add the following to your vimrc file:

   let g:wiki_root = '~/documents/wiki'

3. Now you can open the index file (that is, index.wiki) with <leader>ww and start to add your notes as desired.

For more details, see the full documentation.

Features

• Syntax highlighting for .wiki files (only within the personal wiki)
• Completion of wiki links and link anchors
• Mappings
  • Global mappings for accessing the wiki
  • Local mappings for
    • Navigation (follow links, go back, etc)
    • Renaming pages (will also update links in other pages)
    • Creating a table of contents
    • Toggling links
    • Toggling lists (marking as done/undone or add/remove TODO)
    • Running code snippets (Note: This needs work)
    • Viewing wiki link graphs
• Support for journal entries
  • Navigating the journal back and forth with <c-j> and <c-k>
  • Support for parsing journal entries in order to make weekly and monthly summaries. The parsed result needs manual editing for good results.
• Text objects
  • iu au Link url
  • it at Link text
  • ic ac Code blocks
  • il al List items
• Folds
• Third-party support
  • CtrlP: CtrlPWiki command
  • Sources for unite and denite

TODO

This plugin was initially a personal project that I never really intended to share. After having used it for quite some time, I have realized that it might be useful to more people. However, there is a lot of work to be done to make this plugin more community friendly.

This is a list of TODO items that anyone may follow up on. I am very willing to accept contributions, both as issues describing problems or as pull requests for implementing bug fixes or missing features.

• Features
  • New features
    • vimwiki like TODO list toggles (cf. #1)
    • Allow journal entries per week/months (cf. #2)
    • Improve the "execute code section" feature

Related projects

• vimwiki
• vim-waikiki

Acknowledgements

Without vimwiki, thus plugin would never have existed. So my thanks go to the smart people that developed and maintains vimwiki, both for the inspiration and for the ideas.