vimwiki使用技巧

vimwiki强大的功能便是markdown语法的使用和强大的html输出,因此,如果能够很好的使用这个插件,写一些能够在网页上显示的内容,如博客等非常强大(github上建博客对于技术人员来说很流行),那么,我们就开始把。

基本vim语法如下:

1= 一级标题 = 2== 二级标题 == 3=== 三级标题 === 4此次类推。 5 6当标题前面有空白时,标题文本居中对齐。 7 = 我是居中的标题 = 8 9*粗体* _斜体_ ~~删除线~~ `Some Code 代码` 10 11注意 这几个针对文本格式的标签,都要求左右留有空白。 12请注意你的代码高亮,一般来说,有了相应的高亮,你用的wiki标签才生效。 13 14^^,,,,15 16 四个空格缩进的内容会被转成blockquote 17 18{{{ class="brush:php" 19这中间的内容会被放到一个 pre 里,适合贴代码。 20上面的 class 是可选的,一般用来安排代码高亮。 21事实上,这一块代码展示就是放在了一个 pre 里。 22}}} 23 24WikiItem 大写开头的驼峰英文会被自动当作一个维基词条,并添加链接 25[[Wiki Item]] 这是手动建立维基词条的方式 26[[wiki item|description]] 输出HTML时显示description,链到 wiki item 27http://ktmud.com/ 外部URL会被自动转换成链接 28[http://ktmud.com Ktmud] 带文字的外链 29[images/hello.jpg] 输出 <img src="images/hello.jpg" /> 30[[images/hello.jpg]] 输出图片,并链向图片地址 31 32* 无序列表 条目一 33* 无序列表 条目二 34 - 子列表 条目一 35 - 自列表 条目二 36 37# 有序列表 条目一 38# 有序列表 条目二 39 40*- 是等价的,后面必须跟一个空格

特殊占位符:

1在wiki条目中使用以下占位符,能对生成的HTML文件做一些特殊的处理。 2 %toc 自动生成的目录 3 %title 指定HTML文档的title,建议放到文档最末尾。如果不指定,title 就是文件名 4 %nohtml 告诉 vimwiki 不为某条目生成HTML文件。即使你在该条目打开时为它单独执行 :Vimwiki2HTML ,也不会生成

键操作:

1快捷键总览 2 <leader>ww 在当前窗口打开维基首页 3 <leader>wt 在新tab打开维基首页 4 <leader>w<leader>w 打开/新建当天日记 5 <leader>w<keader>t 在新tab打开/新建当天日记 6 <leader>ws 选择维基项目(详见下面的“多个维基项目”一节) 7 8尚未建立的词条会被显示为红色(或其他你的 Vim 语法高亮定义的错误颜色),在词条上敲回车键,可以编辑这个词条。点击 Shift-回车,在新的分割窗口编辑该词条。编辑好以后点击退格(Backspace)键,可以返回链入页 9 使用 Tab 键,可以跳到下一个维基词条或链接,使用 Shift-Tab 跳到上一个 10 插入模式下使用Shift-Enter,插入 <br> 并换行 11 在标题上点击 -= (也就是 -+ ),可以分表提升和降低标题层级

另有条目管理相关的快捷键 <leader>wd<leader>wr ,分表代表删除和重命名当前条目。其中重命名条目很强大,还能更改所有其他条目内引用了该条目的链接。 重命名之后别忘了重新生成所有条目的HTML。

更改一点默认配置

转自:http://wiki.ktmud.com/tips/vim/vimwiki-guide.html

1" vimwiki 2 3" 是否在词条文件保存时就输出html 这个会让保存大词条比较慢 4 所以我默认没有启用 有需要的话就把这一行复制到下面去 5" \ 'auto_export': 1, 6 7" 多个维基项目的配置 8let g:vimwiki_list = [{'path': 'E:/My Dropbox/vimwiki/', 9 \ 'html_header': 'E:/My Dropbox/Public/vimwiki_template/header.htm', 10 \ 'html_footer': 'E:/My Dropbox/Public/vimwiki_template/footer.htm', 11 \ 'diary_link_count': 5}, 12 \{'path': 'Z:\demo\qiuchi\wiki'}] 13 14" 对中文用户来说,我们并不怎么需要驼峰英文成为维基词条 15let g:vimwiki_camel_case = 0 16 17" 标记为完成的 checklist 项目会有特别的颜色 18let g:vimwiki_hl_cb_checked = 1 19 20" 我的 vim 是没有菜单的,加一个 vimwiki 菜单项也没有意义 21let g:vimwiki_menu = '' 22 23" 是否开启按语法折叠 会让文件比较慢 24"let g:vimwiki_folding = 1 25 26" 是否在计算字串长度时用特别考虑中文字符 27let g:vimwiki_CJK_length = 1 28 29" 详见下文... 30let g:vimwiki_valid_html_tags='b,i,s,u,sub,sup,kbd,del,br,hr,div,code,h1'

做一个你自己的模板

vimwiki 生成的HTML会都会链接相应vimwiki_html目录下的style.css。如果你不自己指定,它会自动生成一个默认的。CSS禅意花园的境界是 什么来着,仅仅修改 style.css 就能拥有风格完全不同的页面。通过简单修改 style.css ,你完全可以创造自己风格的维基站。加上自定义文档头部和尾部的功能,折腾出一个个人网站来绰绰有余。当然,如果你还在想新闻列表,feed订阅什么的, 请赶快走开。毕竟, vimwiki 不是 CMS 。

可惜的是,并不能指定一个 style.css 的模板,如果你还折腾了一些 JavaScript 增强,就更麻烦了。需要的话请自行把相关文件复制过去吧。当然,你也可以直接把本页面另存为,使用我的模板!具体实现请自己折腾。

点赞
收藏

评论区

加载中...

相关推荐

SVN管理工具Cornerstone for Mac永久激活版

Cornerstonemac版是MacOS上最好用的SVN管理工具,除支持基本的SVN功能外,还能够和Xcode,BBEdit,TextMate,Coda等开发工具无缝的集成使用,其时间线功能能够非常方便的查看一个文件的历史改动情况,具有强大的合并,比较功能。

Markdown基础语法学习

Markdown学习标题三级标题:空格标题四级标题:空格标题一级、二级以此类推(最多六级)字体样式helloworld&nbsp;&nbsp;斜体:&nbsp;helloworld(注意星号和单词之间是没有空格的,下同)helloworld&nbsp;&nbsp;加粗:&nbsp;&nbsp;hellowor

利用 Apifox 的 Mock 功能快速构建业务数据模拟场景

Apifox拥有强大的功能,兼容Mock.js语法的同时还提供Nunjucks和自定义脚本支持,能够满足不同场景需求。今天给大家分享一些常见业务场景的Mock使用技巧,当然,实现的方法不唯一。在开始之前,你需要将的当前环境切换为「本地Mock」或「云端Mo

Swift学习第一练——用Swift实现的FlappyBird小游戏

用Swift实现的FlappyBird小游戏   伴随着apple公司对swift的推广态度深入,swift火的很快,并且swift精简便捷的语法和强大的功能,对于使用Object—C开发iOS的开发者来说,也有必要了解学习一下swift。这篇博客跳过swift干涩的语法,直接从一个小游戏项目开始使用s

Markdown语法

Markdown基本语法\TOC\优点:1、因为是纯文本,所以只要支持Markdown的地方都能获得一样的编辑效果,可以让作者摆脱排版的困扰,专心写作。2、操作简单。比如:word编辑时标记个标题,先选中内容,再点击导航栏的标题按钮,选择几级标题。要三个步骤。而Markdown只需要在标题内容前加即可缺点:1、需要记一

Github怎么写README

编辑README文件大标题(一级标题):在文本下面加等于号,那么上方的文字就变成了大标题,等于号的个数无限制,但一定要大于0大标题\中标题(二级标题):在文本下面加下划线,那么上方的文本就变成了中标题,下划线个数无限制,中标题比大标题低一级中标题\1~6级标题:文本大小依次减小,以号开头,多少个号就是多