2010/6/11 [投稿]Pkm工具：Vimwiki|善用佳软

[投稿]Pkm工具：Vimwiki
本文作者：Yibie，版权归属「Geek4us」、「学无止境@一点一滴」

阅读本文之前，首先你要确保，你会用Vim，懂得配置Vim的配置文件。如果不懂，请上网自
行搜索Vim入门教程，已经有很多中文资源，我就不再解释了。

1.0 Vimwiki的安装
1.1 从以下链接中下载Vimwiki插件:
http://www.vim.org/scripts/script.php?script_id=2226

将下载到的vimwiki.vba文件放到vim的安装目
录”~\Vim\vim72\plugin”或”~\Vim\vimfiles\plugin”下

用Vim打开vimwiki.vba,然后在”Normal模式”下,输入命令’:so %’,等一会儿,安装将自动
完成.

1.2 在Vim的配置文件中添加以下命令:
” vimwiki
let g:vimwiki_use_mouse = 1
let g:vimwiki_list = [{'path': '~/vimwiki/',
\ 'path_html': '~/vimwiki/html/',
\ 'html_header': '~/vimwiki/template/header.tpl',}]

这个命令的目的是，修改你存放Vimwiki文件的地方，否则会默认安装存放在系统盘用户文件
夹下（如果是在XP下，应该是在「我的文档」下面；如果是Windows7，则在「用户」这个文
件夹下）。

例如：

” vimwiki
let g:vimwiki_use_mouse = 1
let g:vimwiki_list = [{'path': 'E:/vimwiki/', （这个是修改存放Vimwiki文
件的地方，Vimwiki的文件后缀为.wiki）
\ 'path_html': 'E:/vimwiki/html/', （这个是修改存放Vimwiki下把wiki文件
转换为Html网页的地方）
\ 'html_header': 'E:/vimwiki/template/header.tpl',}] （这个是修改存放
Vimwiki转换网页时用的网页模板的地方）

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

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

http://xbeta.info/vimwiki.htm 1/7
2010/6/11 [投稿]Pkm工具：Vimwiki|善用佳软
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键盘指令
首先,要明白,在Vim里面,输入指令是指在”Normal”状态下,敲击键盘上的按键,就是输入指
令

如果有什么不懂,可输入在”Normal”下输入”:h vimwiki-mappings”查询

normal mode:

<Leader>ww — 打开默认的wiki主页

<Leader>wt — 在新的标签页中打开默认的wiki主页

<Leader>ws — Select and open wiki index file.(未知)

<Leader>wd — 删除你所在的wikiword的页面

<Leader>wr — 重命名你所在的wikiword页面

Enter — 在当前页面中新建新的wikiword页面

Shift-Enter — 新建一个wikipage,并在新的分割窗口中显示出来

Ctrl-Enter — 新建一个wikipage,并在新的分割窗口中显示出来(Vertical split and

folow/create WikiPage)

Backspace — 返回上一页

Tab — 寻找下一个wikiword

Shift Tab — 寻找上一个wikiword

2.3 Vimwiki输入指令
输入’:Vimwiki2HTML — 将当前wiki页转换成Html格式’
http://xbeta.info/vimwiki.htm 2/7
2010/6/11 [投稿]Pkm工具：Vimwiki|善用佳软

输入’:VimwikiAll2HLML — 将所有的wiki页转换成HTML格式’

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

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

（本文档，还未完成，将持续更新）

A1:本文信息
[转载请保留]　作者:善用佳软　出处:http://xbeta.info/vimwiki.htm
日期：2009-12-22　　分类：1.4 信息管理　　 标签：gvim, PIM/PKM　　 评论：22

A2:相关阅读
VOoM(原VOOF)：vim实现带折叠双栏树状文本管理(更新)
myBase: 功能最全面的资料管理软件(v6 测试版)
WikidPad：wiki风格的开源树状笔记管理软件
Wiz(为知个人知识管理): 网文快捕新一代产品
TxtBrowser: 在Vim中高效处理纯文本(更新)
Vimperator：VIM化的Firefox(新增tc网友投稿)
CreaWriter: 可用AutoHotkey模仿之

前一篇：« 大道至简: 用pre统一txt与html来记笔记

后一篇：» Tobu: 海量文本信息管理软件

B1:已有评论22 条 ↗ ↙
希锐亚: 2009-12-22 12:58, #13476

我最想要的是版本记录功能，而wiki的格式我并不喜欢，已经有html了，wiki的语法只
是把事情搞得更复杂了。

回复

bigclean: 2009-12-22 18:55

http://xbeta.info/vimwiki.htm 3/7
2010/6/11 [投稿]Pkm工具：Vimwiki|善用佳软

版本记录可以用相应的版本控制工具(svn,git)，wiki只是作为载体而已，wiki简洁还
是可以提高生产力的。

回复

bigclean: 2009-12-22 18:50, #13479

似乎忘了介绍vimwiki的后端delplate，用ruby写的还不错的wiki工具。在使用过的轻
量标记wiki语言中，最喜欢的还是txt2tags和asciidoc，比较通用，而且前者很简单，
导出格式也很多，后者是很强大（依赖于docbook）。vim的vimwiki和emacs的muse或是
emacs-wiki都还是太依赖于具体软件了，相对来说还是muse更好，而且deplate的初衷
也是作为muse的vim的clone。

回复

Yibie: 2009-12-22 19:44

那个是 Vim 另外一个插件——Viki所使用的后端，在Vimwiki中，输出网页不需要通过

其他工具转换

回复

bigclean: 2009-12-23 10:39

还是不大喜欢用vba安装vim的插件，vimwiki的上个版本自己安装也会出错，也没有深
究过。
或许vba也是vim插件的未来格式，可能会方便一点，总是感觉用代码控制起来不大容
易。
vimviki输出网页不需要后端，deplate安装还要通过rubygems进行，实在很烦，有空再
好好试试。

回复

Yibie: 2009-12-22 19:58

我知道Muse，但是 Emacs 的学习曲线比 Vim 更加陡峭，而且对于我这个非计算机行业

的人员来说，Emacs 基本上是没有必要去探究的，除非出自于兴趣

txt2tags的使用，一直无法明白…

首先还是要从自己能懂的工具下手吧

回复

bigclean: 2009-12-23 10:35

emacs的确是学习的成本有点太大了。muse一个很不错的特性是插入图片是可视化的，
而且各级标题是会有大小区别，只是这个特性是由emacs提供的。
txt2tag和ascciidoc都是单py文件，需要python的运行环境，可能更多的是依赖于命令
行（cmd或是shell）或是用makefile管理。可以参考一下这篇中文介绍，
http://sunxun.info/2009/08/txt2tags-basic/。
还有markdowm也很不错，wordpress也有相应的插件支持，可以试试。

回复

Yibie: 2010-01-24 14:16

http://xbeta.info/vimwiki.htm 4/7
2010/6/11 [投稿]Pkm工具：Vimwiki|善用佳软
终于是知道了 txt2tags 是个超牛的工具~看看能否和vimwiki结合吧~如果是这样就好
了

winstarst: 2010-04-28 17:46

以前用过DocBook，只是标记太复杂，推广不方便，看了你的说明找到了txt2tags，觉
得是目前最适合我的解决方案了，并且最新的SVN版本已经支持Docbook了，以后就用它
了，还是基于Python的，可以自己动动了，呵呵，谢过了。。

回复

tc: 2009-12-22 20:33, #13487

vimwiki这个插件第一眼看到的时候就觉得不错
完全读完它的帮助文件，就知道，这就是我想要的，不要为了voof的双边框就安装个
python
感觉真的没有必要，在windows平台下.
另外，vimwiki的转换网页功能也不错.值得使用

回复

http://t.chinaren.com/xinwenjiang: 2009-12-23 10:14, #13489

http://t.chinaren.com/xinwenjiang审核结果

回复

田鼠007: 2009-12-23 10:23, #13490

当英文单词里面有连续两个英文字母为写’WikiWord’,这句话好象写得不通啊……

回复

天毅: 2009-12-23 10:30, #13491

不知道善用佳软在用firefox的时候，有没有在用vimperator，感觉相当不错的一个插
件。

回复

http://t.chinaren.com/xinwenjiang: 2009-12-23 10:47, #13494

请联系我，IT新闻奖候选通过。加我qq或者msn
295788398
chenzhong@live.it

回复

beta: 2009-12-23 21:06, #13503

一个很不错的软件：7-zip9.10重编译中文美化版。
http://hi.baidu.com/wnsh83/blog/item/84746137a5e0fa1a90ef3905.html

回复

发条狐狸: 2009-12-25 17:56, #13569

http://xbeta.info/vimwiki.htm 5/7
2010/6/11 [投稿]Pkm工具：Vimwiki|善用佳软
要是图片有移到网络链接上就显示的功能就爽了.

回复

天毅: 2010-01-09 9:26, #14341

想问个问题，和vim兼容性比较好的拼音输入法是哪个？搜狗打“无奈”和按2选词的时
候会执行vim里的其它命令，很无奈
【善用佳软：无法具体回答，因为不用拼音。我认为这是输入法的bug，还上升不到兼
容的层面（一般说vim兼容是指支持normal模式自动英文，i模式自动中文），猜测：换
一个sogou版本，或者随便换一款google, 紫光等应该都行吧。】

回复

Yibie: 2010-01-24 14:00

现在vim有vimim输入法插件，可以直接在vim下输入汉字而不必启用输入法软件

回复

goreycn: 2010-01-29 16:04, #15115

原文：将下载到的vimwiki.vba文件放到vim的安装目
录”~\Vim\vim72\plugin”或”~\Vim\vimfiles\plugin” 下

这一步不是必需的，放在哪里都一样，应该这个文件装好后，是用不到的，删了都可
以。

至少，我在Win,Mac里装都没有放到上面所说的位置。

回复

ytao: 2010-03-06 16:50, #15799

我装过几个版本的vimwiki，不知怎么的，无法用GoHome功能到index，每次都会报错。
也许是我的配置有问题吧。

回复

yt: 2010-04-24 11:12

我也是，只好使用热键自己打开index.wiki了。

回复

Leon: 2010-06-05 10:14, #17447

不知道怎样添加新词条。按Enter没有反应。

回复

我要发表评论 ↗
您的留言：
NOTICE: You should type some Chinese word (like “你好”) in your comment to
pass the spam-check, thanks for your patience!

http://xbeta.info/vimwiki.htm 6/7