个人知识管理:Vimwiki工具

Yibie · · 原载 GTDStudy

本文版权归属「Geek4us」

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

Vimwiki的安装

从以下链接中下载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 %’,等一会儿,安装将自动完成.

在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转换网页时用的网页模板的地方)

Vimwiki的语法

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

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

普通语法:

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 ===

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

Vimwiki输入指令

输入’:Vimwiki2HTML – 将当前wiki页转换成Html格式’

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

Vimwiki的特性

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

Vimwiki的一些缺点

  • 没有下划线的wiki语法

(本文档,还未完成,将持续更新)

本文原发表于 http://www.gtdstudy.com/?p=1350,于 2026 年据 Internet Archive 的存档恢复,原评论未能保留。

← GTDStudy 存档