VimWiki 官方称之 a personal wiki for Vim ，一个基于 Vim 的 Wiki 系统，对于 Vim 控来说，这是一个非常不错的用于个人知识管理的利器，并且还支持输出到网页。之前我一直用 dokuwiki ，现在也逐渐转向用这个。

项目主页： http://code.google.com/p/vimwiki/

# 安装和使用：以下内容转载自善用佳软件的文章，更详细内容请看原文。

Update: 官方主页上有一份详细的中文文档。

安装： 到 VimWiki 官方主页或 VIM 插件页下载 vimwiki.vba 文件到任意目录。 用Vim打开vimwiki.vba文件，然后在"Normal模式"下输入命令’:so %’，等一会儿，安装将自动完成。

使用： Vimwiki 的语法可参考这份 PDF 文档

1 Vimwiki的基本配置

Vimwiki的一些基本配置需要在vim配置文件中指定，主要是存储路径。

读者可参照下例进行修改，然后放到_vimrc文件中：

" vimwiki
let g:vimwiki_use_mouse = 1
let g:vimwiki_list = [{'path': 'E:/vimwiki/',
\ 'path_html': 'E:/vimwiki/html/',
\ 'html_header': 'E:/vimwiki/template/header.tpl',}]

最后3句分别指定了：
- 存放Vimwiki文件的路径（Vimwiki的文件后缀为.wiki）
- 从Vimwiki转换为Html网页时的保存路径；
- Vimwiki转换网页时使用的网页模板的路径。

2. Vimwiki入门：体验式教程

进入首页
操作：在Vim的Normal模式下，键入 \ww 三个键。
结果：Vim就会打开wiki首页（index.wiki）。
更多说明：① index.wiki所在目录见上述设置。② \ 键实际是<Leader>符，也可自定义。

创建新页面
操作：在首页中随便键入一些文字。比如， “这是wiki首页。 我要创建一个新页面 NewPage。”
结果：NewPage 会高亮显示。

更多说明：

- NewPage 这样的格式称为驼峰词，是创建新页面的最方便的做法。
- 对于更复杂的页面名称或中文页面名称，可以用双方括号表示。比如 [[中文页面]] 将创建 中文页面.wiki。括号内也可以用半角竖线分割，前半部分表示文件名，后半部分表示描述。比如 [[page3|我的第3篇wiki]] 将生成 page3.wiki 文件。而导出为html时，超链接的文字只有描述“我的第3篇wiki”。这种做法可以兼顾文件名的精简、规律、规范，与人工阅读的直观。采用Vim7.3中的最新 conceal text 特性，也可以在wiki中直接隐藏这些不用显示的符号，详见 这篇文章。
- “快速引用某页面，并且，该页面若不存在则自动创建”是wiki的核心优势之一。

跳转到新页面
操作：在 Normal 模式下用光标双击 NewPage。
结果：index.wiki自动保存、关闭。在当前窗口打开了 NewPage.wiki 页面。

更多说明：
- Enter：与双击效果等同，在当前窗口中打开NewPage页面。
- Shift+Enter：上下分割窗口，NewPage在上，原页面在下。
- Ctrl+Enter：左右分割窗口，NewPage在左，原页面在右。

返回首页
操作：在 NewPage 中输入一些内容。进入Normal模式，按BackSpace。
结果：NewPage自动保存；并返回index.wiki页面；此时 NewPage 变成了另外一种高亮（区分

2.1 Vimwiki的基本语法摘要

Vimwiki的下载主页上面给出一个快速学习Vimwiki语法的知识卡片(pdf格式,可通过一些软件转换为图片),从上面便可知道所有的Vimwiki中使用的语法,十分简单,方便使用.

PDF地址: http://habamax.ru/myvim/data/vimwikiqrc.pdf

2.1.1 普通语法:

*bold* — bold
_italic_ — italic
WikiWord — link to WikiWord （这是驼峰词的用法）
[[complex wiki link]] — link to complex wiki link
Indent lists with at least 1 space:
* bullet item
# numbered list item
= Header1 =
== Header2 ==
=== Header3 ===

2.2 Vimwiki键盘指令
<Leader>ww — 打开默认的wiki主页
<Leader>wt — 在新的标签页中打开默认的wiki主页
<Leader>ws — Select and open wiki index file.(未知)
<Leader>wd — 删除你所在的wikiword的页面
<Leader>wr — 重命名你所在的wikiword页面
Backspace — 返回上一页
Tab — 寻找下一个wikiword
Shift Tab — 寻找上一个wikiword
如果有什么不懂,可输入在"Normal"下输入":h vimwiki-mappings"查询

2.3 Vimwiki发布为html网页
Vimwiki可导出为html格式，便于发布为网页。
输入’:Vimwiki2HTML — 将当前wiki页转换成Html格式’
输入’:VimwikiAll2HTML — 将所有的wiki页转换成HTML格式’

3. Vimwiki的优点与缺点

3.1 Vimwiki的优点
与Vim紧密结合,可使用Vim的内建的正则表达式规则,高效处理文本
与Vim紧密结合,可利用Vim内建的多种命令,以及可显示多个分页的特性,同时展示多种窗口,快速查看多份资料.
由于Vim是文本处理工具,所以任何笔记,只要存为文本数据,便可以用Vim来组织和整理
内置了特别的语法高亮模式,在观感上与普通见到的wiki没有多大的分别.
可利用’:VimwikiAll2Html’这个命令快速将文本转化为网页.
在Vim中自动识别网络链接格式,点击便可打开网页.
在Vim的"Normal模式"下,在某行字句上面敲击"="可自动为该字句添加标题语法
自动添加wikiwork,当英文单词里面有连续两个英文字母为写’WikiWord’,Vimwiki会自动识别并将其标记为wikiword.该特性仅针对英文.

3.2 Vimwiki的一些缺点
没有下划线的wiki语法
由于是基于文本处理软件所开发的插件，所以无法支持导入图像、音频、视频等格式，同时也无法添加附件，但可以通过添加文件链接、或是网络链接的方式变通