Markdown是John Gruber設計的一個文本標記系統,相比html,它很簡單,便於手工編寫,而且它還支持WordPress , 有一個用於wordpress的插件 。 青蛙決定用vim+Markdown來編寫blog,看起來他們是一對強大的組合 ![]()
首先要去Vim的官方網站下載Markdown的語法高亮插件 ,並把它複製到”~/.vim/syntax/”目錄下面。 然後,新建一個”~/.vim/ftdetect/mkd.vim”文件,在其中加入下面的內容:
” markdown filetype file
if exists(“did_load_filetypes”)
finish
endif
augroup markdown
au! BufRead,BufNewFile *.mkd setfiletype mkd
augroup END
並在”~/.vimrc”文件中添加如下內容:
“Markdown language syntax settings
augroup mkd
autocmd BufRead *.mkd set ai formatoptions=tcroqn2 comments=n:>
augroup END
然後,後綴名為”.mkd”的文件就能被自動啟用Markdown的語法高亮了。
下面是Markdown語法的簡要列表,便於以後查閱。 以下內容主要從牧碼志整理,感謝leninlee的辛勤勞動。
- 鏈接的添加,共有三種形式,Markdown支持相對鏈接。
<鏈接> :這種形式只是簡單的標出鏈接;
[文字](鏈接“標題”):給文字添加鏈接,其中標題是可選的;
[文字][標記]:給文字添加鏈接,鏈接在下面的一個以[標記]開頭的新行(一般是文章末尾)給出。 或者直接以[文字][]這種形式編寫,在下面的新行中使用[文字]:鏈接的形式聲明鏈接。 - 圖片的添加:跟鏈接比起來,圖片只是多了在前面多了一個嘆號”!”。
- 標題格式:Markdown提供了2種方式。
第一種是在標題前面加上1~6個”#”表示”<h1>”~”<h6>”。
第二種是在標題下面另起一行,輸入四個以上的等號“=”來表示”<h1>”,輸入四個以上的減號“-”來表示”<h2>”。 - 粗體和斜體:用星號”*”或者下劃線”_”
一個表示斜體;
兩個表示粗體;
三個表示粗斜體。 - 引用內容:就是html標記的”<blockquote>”,只要在行首用右尖括號>就行了。 如果要嵌套引用,那就多打幾個>。
- 原文輸出:如果不想Markdown解釋某些內容,有兩種方式:
第一個是轉義為html的”<pre>”標籤:要在要原樣輸出的內容前面加入至少4個空格或者1個tab的寬度;
第二個是轉義為”<code>”標籤:給要輸出的內容加上”`”號(就是esc下頭那個鍵)。 - 無序列表:在文字前面使用星號”*”、加號”+”、減號”-”中的任意一個,注意在這些符號後面要留一個空格。
- 有序列表:在第一條前添加一個數字,後跟一個英文句點”.”。 無論第一個條目前加的數字是什麼,列表都會從1開始計數。
- 轉義符:”\”。 只要給不希望被轉義的字符前面加上\就可以了。
- HTML實體:如果要在內容中輸出”<”或者”&”符號,那麼必須用[HTML實體][]代替。 Markdown會把HTML的特殊符號直接翻譯為HTML實體。
- 換行符:Markdown中在一行的末尾使用兩個以上的空格標示HTML中的一個換行符”<br/>”。
- 段落:只要兩行之間有一個空行,Markdown就會把它識別為一個段落。
(青蛙在寫這篇文章的時候發現,在列表之前一定要加入一個空行,要不然Markdown是不會把”*”識別為列表的。) - 水平線:使用三個以上的”*”或”-”來表示。 這些星號跟減號之間可以用空格,如果減號沒有空格,
那它必須在單獨的一個段落裡,要不它會被識別為標題的。 - 直接使用HTML標記:有些Markdown不支持的標籤可以直接寫HTML標記,例如表格。
update,2008-03-20:青蛙發現直接向wordpress寫Markdown格式效果真的很差,而且不方便編輯,所以青蛙決定還是在本地把Markdown文檔轉化為HTML格式再發佈到blog上好了。







