Mac下markdown环境搭建

前言

作为一个研究僧,一直有记笔记的习惯,之前在用OneNote,后来因为要开发ROS,彻底放弃了Windows阵营,在Mac和linux下来回切换,好在俩系统通用bash,考虑到兼容性、轻量性、以及最重要的优(zhuang)雅(bi)性就尝试着用vim写Markdown来记笔记(我已经隐忍OneNote很久了:臃肿,占系统资源大,默认字体bug不修复,时不时来个闪退。我只想优雅高效地记笔记而已,OneNote的功能我80%都用不到)。Mac下我还是以xcode自带的编辑器为主,如果后期要看笔记的话,通过vim来预览(主要是看大量代码,其实xcode自带编辑器基本能满足查看需求),linxu下还是通过vim来编辑和预览。

BOM

  • Xcode:自带的编辑器编写markdown文档肥肠好用。虽然不能完全的预览,但是已经进行了一些处理,比如标题大小会自动调整,也有语法的高亮,自带的目录也能快速的定位,还有是Mojave系统的暗黑主题,苹果自家的软件优先适配,非常舒服。


    Xcode编辑器效果图
  • vim:基本所有的UNIX like 系统都自带,在终端输入vim 就可以进去vim模式

  • vundle:一个管理vim插件的管理器, 以下所有的插件都是用vundle来管理安装和卸载。

  • vim-instant-markdown:一个在浏览器中预览markdown文档的vim插件

  • vim-markdown:vim的 markdown语法高亮插件

安装vundle

  1. 用下面的指令把vundle安装在~/.vim/bundle/ 目录下
git clone https://github.com/VundleVim/Vundle.vim.git ~/.vim/bundle/Vundle.vim
  1. 在~/.vimrc 中添加一下的代码
    看到这么多代码不用慌,其实就是告诉你在指定的地方加上例如:“Plugin 'VundleVim/Vundle.vim“,来安装你需要的vim插件,文末会贴上我自己的vimrc,复制粘贴就可以。
set nocompatible              " be iMproved, required
filetype off                  " required

" set the runtime path to include Vundle and initialize
set rtp+=~/.vim/bundle/Vundle.vim
call vundle#begin()
" alternatively, pass a path where Vundle should install plugins
"call vundle#begin('~/some/path/here')

" let Vundle manage Vundle, required
Plugin 'VundleVim/Vundle.vim'

" The following are examples of different formats supported.
" Keep Plugin commands between vundle#begin/end.
" plugin on GitHub repo
Plugin 'tpope/vim-fugitive'
" plugin from http://vim-scripts.org/vim/scripts.html
" Plugin 'L9'
" Git plugin not hosted on GitHub
Plugin 'git://git.wincent.com/command-t.git'
" git repos on your local machine (i.e. when working on your own plugin)
Plugin 'file:///home/gmarik/path/to/plugin'
" The sparkup vim script is in a subdirectory of this repo called vim.
" Pass the path to set the runtimepath properly.
Plugin 'rstacruz/sparkup', {'rtp': 'vim/'}
" Install L9 and avoid a Naming conflict if you've already installed a
" different version somewhere else.
" Plugin 'ascenator/L9', {'name': 'newL9'}

" All of your Plugins must be added before the following line
call vundle#end()            " required
filetype plugin indent on    " required
" To ignore plugin indent changes, instead use:
"filetype plugin on
"
" Brief help
" :PluginList       - lists configured plugins
" :PluginInstall    - installs plugins; append `!` to update or just :PluginUpdate
" :PluginSearch foo - searches for foo; append `!` to refresh local cache
" :PluginClean      - confirms removal of unused plugins; append `!` to auto-approve removal
"
" see :h vundle for more details or wiki for FAQ
" Put your non-Plugin stuff after this line
  1. 安装插件
    在vim的命令行模式下输入:PluginInstall,就会自动安装vundle,以下的vim插件都是通过vundle安装的。

安装vim-instant-markdown

安装vim-instant-markdown插件首先要安装node.js。

  1. 安装 node.js
  • Mac 去官网安装 node.js,下载完成后是一个pkg文件,双击安装完成。测试是否安装完成如果显示版本号则表示成功了。
终端输入
node -v
npm -v 
  • linux下安装node.js
sudo apt-get install nodejs
sudo apt-get install npm
  1. npm安装instant-markdown-d
sudo npm -g install instant-markdown-d
  1. vim下安装instant-markdown-d插件
    其实就是在vimrc中添加下面的语句,大家可以复制文末的vimrc 然后用:PluginInstall一并安装所有的插件。
Plugin 'suan/vim-instant-markdown' 

两个重要参数

接下来介绍两个比较常用的设置参数,更多参数详见github主页

  1. g:instant_markdown_slow
    这个参数决定了你写的markdown会不会实时地在浏览器上更新预览(实时预览可能会占用一些计算机性能)。如果你不希望实时预览在 ~/.vimrc中设置 g:instant_markdown_slow = 1。一旦设置之后这个预览更新只会在你停止输入一段时间后生效,以及离开vim编辑模式之后生效。
  2. g:instant_markdown_autostart
    顾名思义,这个是决定你打开vim的同时,会不会自动在浏览器上开启预览。如果你不希望自动开启预览,那么就在~/.vimrc设置:g:instant_markdown_autostart = 0。如果你手动开启预览,则在vim命令模式下输入:InstantMarkdownPreview(我们当然可以用vim的键值映射来替换掉这个复杂输入,比如我就替换成了F1)

安装vim-markdown

本人在mac下用xcode 作为markdown的主要编辑器,只把vim作为预览查看器。但是考虑到vim的通用性,在linux下还是要用vim来写。所以顺带也把语法高亮的插件也安排了。安装过程也是用vundle安装:

Plugin 'godlygeek/tabular'
Plugin 'plasticboy/vim-markdown'

vimrc

下面是我的vimrc配置,主要包含了vundle所需的一些插件,以及vim的一些实用配置:显示行号,配色。我默认markdown的预览不自动开启,通过F1来启动。同时为了降低计算机负担把实时预览关了。复制到~/.vimrc 后在vim中输入:PluginInstall就会自动安装所有的插件。

set nocompatible              " be iMproved, required
filetype off                  " required

" set the runtime path to include Vundle and initialize
set rtp+=~/.vim/bundle/vundle/
call vundle#rc()
" alternatively, pass a path where Vundle should install plugins
"let path = '~/some/path/here'
"call vundle#rc(path)

" let Vundle manage Vundle, required

Plugin 'gmarik/vundle'
Plugin 'godlygeek/tabular'
Plugin 'plasticboy/vim-markdown' 
Plugin 'suan/vim-instant-markdown'

" The following are examples of different formats supported.
" Keep Plugin commands between here and filetype plugin indent on.
" scripts on GitHub repos
" The sparkup vim script is in a subdirectory of this repo called vim.
" Pass the path to set the runtimepath properly.
" scripts from http://vim-scripts.org/vim/scripts.html
" git repos on your local machine (i.e. when working on your own plugin)
" ...

filetype plugin indent on     " required
" To ignore plugin indent changes, instead use:
"filetype plugin on
"
" Brief help
" :PluginList          - list configured plugins
" :PluginInstall(!)    - install (update) plugins
" :PluginSearch(!) foo - search (or refresh cache first) for foo
" :PluginClean(!)      - confirm (or auto-approve) removal of unused plugins
"
" see :h vundle for more details or wiki for FAQ
" NOTE: comments after Plugin commands are not allowed.
" Put your stuff after this line


syntax enable
syntax on
set autoindent
set nu
set tabstop=4
" 总是显示状态栏
set laststatus=2
" 显示光标当前位置
set ruler
" 高亮显示当前行/列
set cursorline
" 高亮显示搜索结果
hi Search term=standout cterm=bold ctermfg=7 ctermbg=1

let g:instant_markdown_slow = 1
let g:instant_markdown_autostart = 0
map <F1> :InstantMarkdownPreview<CR>
set nofoldenable

效果图

  • vim配置完之后的效果


    效果图
  • 浏览器预览的效果
    用浏览器可以保存成pdf离线查看


    浏览器预览图
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,921评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,635评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,393评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,836评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,833评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,685评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,043评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,694评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,671评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,670评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,779评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,424评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,027评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,984评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,214评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,108评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,517评论 2 343

推荐阅读更多精彩内容