Markdown語法摘要

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
augrou​​p markdown
au! BufRead,BufNewFile *.mkd setfiletype mkd
augrou​​p END

並在”~/.vimrc”文件中添加如下內容:

“Markdown language syntax settings
augrou​​p mkd
autocmd BufRead *.mkd set ai formatoptions=tcroqn2 comments=n:>
augrou​​p 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上好了。

About gfrog

gfrog,Coder. Canon 40D, Seagull 4B, Seagull 2​​03, Blackberry 8100, Thinkpad, Debian Linux
This entry was posted in VIM and tagged , . Bookmark the permalink .
  • 聽臨

    不錯,學習了…

    mac 下用TextMate 寫MD 很舒服…

  • http://www.facebook.com/ Cassara

    Alright alighrt alright that's exactly what I needed!

  • http://yishanhe.net yish

    學習了,非常感謝~

  • tang also

    謝謝博主的分享。

  • 匿名

    總結的很簡明易懂,謝謝博主分享。