markdown 即时预览

作为一枚热衷开源的伪 geek,github.com 与我同在。发布在 github.com 的任何项目你得有个项目简介,README.md,这是一种用 markdown 文书编写语法制作的说明文档。关于 markdown,我有两个需求,一是 vim 要高亮显示 markdown 语法,一是 firefox 要能渲染其语法、即时显示更新结果。

第一个需求不是问题,新版 VIM 已经集成了 Markdown 语法高亮插件,无须单独配置。

第二个需求,按照一般逻辑,应该通过 Firefox 的某款插件来实现,的确,Markdown Viewer 看起来是干这个事儿的,但它响应速度缓慢、中文显示乱码、无法即时渲染等等问题让我无法接受。网上倒是有些即时渲染 Markdown 的网站,比如,https://stackedit.io/editor ,左侧编辑右侧显示,所见即所得,但这又无法让我使用 VIM,不行。还是回到 VIM 身上想办法,vim-instant-markdown 来了。有了这款 VIM 插件,一旦你启用 VIM 编辑 Markdown 文档,vim-instant-markdown 自动开启 Firefox 为你显示 Markdown 最终效果,如果你在 VIM 中变更了文档内容,vim-instant-markdown 即时渲染、Firefox 同步更新,太棒了!

Markdown 即时渲染Markdown 即时渲染

vim-instant-markdown(https://github.com/suan/vim-instant-markdown ) 的安装相比其他插件较为特殊,它由 Ruby 开发,所以你的 VIM 必须集成 Ruby 解释器(见“1 源码安装编辑器 VIM ”),并且安装 pygments.rb、redcarpet、instant-markdown-d 三个依赖库:

gem install pygments.rb
gem install redcarpet
# 若系统提示无 npm 命令,你需要先执行 zypper --no-refresh install nodejs
npm -g install instant-markdown-d

注意,以上三条命令均要翻墙。对于重内容、轻设计的我这类人来说,Markdown 简洁的文书语法太贴心了。推荐三个网站:

下一节:代码中不可能全是英文,即便注释是英文,用户提示信息也多多少少得用中文吧,所以,在 vim 中输入中文是常有的。中/英文输入切换本身很简单,但是,如果又与 vim 的插入模式和命令模式一纠缠,那么,这事儿就不太自然了。