在vim中設置markdown語法高亮是一個不錯的選擇,但是在google中搜索到的很多都是比較老的設置方式,甚至vim插件下載頁面都是一個舊的版本。這里總結下我的修改過程,以幫助像我一樣糾結的人。
安裝插件
這個插件的安裝和其他vim插件一樣,都是拷貝相應文件到對應的目錄。
-
將下載的zip文件解壓后,會得到下面的目錄結構:
. |-- syntax | |-- mkd.vim |-- ftdetect | |-- mkd.vim
將兩個 mkd.vim 分別復制到 $VIM 下對應的 syntax 和 ftdetect 文件夾中。
$VIM 對應的目錄在windows和Linux系統上是不同的,相信你在安裝使用vim的時候應該已經注意到了。
-
Mac和Linux下一般是 ~/.vim/,如果沒有對應的文件夾,用mkdir創建
cp ./syntax/mkd.vim ~/.vim/syntax/ cp ./ftdetect/mkd.vim ~/.vim/ftdetect/
- Windows一般就是vim的安裝目錄下了。
-
一切就是這么簡單,復制到對應目錄,然后重啟你的vim就ok了。
插件內容
盡管名字相同,兩個文件夾中的文件是不同的。
- syntax中的 mkd.vim 是關鍵的語法解析文件,里面是關於語法高亮的詳細定義。
-
ftdetect中的 mkd.vim 定義的是自動解析哪些文件。
下面是github最新版本中的定義方式,支持的后綴名包括花括號中的內容,如果有新的定義,可以自己添加
au BufRead,BufNewFile *.{md,mdown,mkd,mkdn,markdown,mdwn} set filetype=mkd
結論
相比較很多之前文章介紹的復雜方式,這個應該是最傳統簡單的了。只要放置對應目錄的文件,不需要在vim用戶配置文件中做任何修改即可使用markdown的語法高亮,比單純的文本明了很多。
在沒有設置vim代碼折疊的 foldmethod 屬性的情況下,默認使用的是 indent 方式。
sudo apt-get install discount
轉換成html文件
# 用discount提供的markdown工具markdown -o Release-Notes.html Release-Notes.md