summaryrefslogtreecommitdiff
path: root/doc/tips/vim_and_ikiwiki.mdwn
blob: eb22e353a76c05a83855b7a21be19ee30ee41f2c (plain)

Vim and ikiwiki

Syntax highlighting

ikiwiki-syntax is a vim syntax highlighting file for ikiwiki [[ikiwiki/markdown]] files. It highlights directives and wikilinks. It only supports prefixed directives, i.e., [[!directive foo=bar baz]], not the old format with spaces.


The previous syntax definition for ikiwiki links is at [[ikiwiki.vim]]; however, it seems to not be [[maintained anymore|forum/navigation_of_wiki_pages_on_local_filesystem_with_vim#syn-maintenance]], and it has some [[issues|forum/ikiwiki_vim_syntaxfile]].

Page creation and navigation

The ikiwiki-nav package is a vim plugin that enables you to do the following from inside vim:

  • Jumping to the file corresponding to the wikilink under the cursor.
  • Creating the file corresponding to the wikilink under the cursor (including directories if necessary.)
  • Jumping to the previous/next wikilink in the current file.
  • Autocomplete link names.

Download it from here