github真的很強(qiáng)大,原來以為只是一個(gè)代碼托管及項(xiàng)目版本控制的網(wǎng)站,沒想到還可以搭建blog及wiki。按照網(wǎng)上的教程,磕磕碰碰的終于搭建好了blog。借著建這個(gè)blog的機(jī)會(huì),學(xué)習(xí)下Markdown和git。首先,學(xué)習(xí)下Markdown標(biāo)記語言,因?yàn)間ithub上blog要求用標(biāo)記語言寫,不學(xué)這個(gè)blog都寫不起來。
本文就是我參考Wow!Ubuntu和維基百科上教程及自己的實(shí)踐寫的(是用Markdown寫的哦),只涉及到Markdown入門語法,學(xué)完后基本上能寫blog??梢允褂迷诰€markdown編輯器學(xué)習(xí),這樣起到“所寫即所得”作用,加深印象。這里介紹一個(gè)在線Markdown編譯器,可以轉(zhuǎn)換成html及實(shí)時(shí)預(yù)覽。好了,開始我們的Markdown學(xué)習(xí)之旅。。
一篇文章首先是標(biāo)題。Markdown支持兩種標(biāo)題語法,Settext和atx形式。
Settext形式:利用底線形式,用 =
(最高級(jí)標(biāo)題) 和 -
(第二級(jí)標(biāo)題)作為底線形式標(biāo)題的標(biāo)記。
atx形式:在行首插入 1 到 6 個(gè) #
,對應(yīng)標(biāo)題 1 到 6 級(jí)(從大到小順序)。
atx比Settext提供更多規(guī)格的標(biāo)題形式,atx中 #
和 ##
分別對應(yīng)Settext中 =
和 -
。
語法示例:
Fisrt Level Header==================Second Level Header-------------------# Header 1 (equal `=`)## Header 2 (equal `-`)
文章中經(jīng)常引用別人的話,為區(qū)別開來可以用引用標(biāo)記特別注明。Markdown中使用email形式的 ‘>
‘(右尖括號(hào)號(hào))??梢栽谝枚温淝凹右粋€(gè),也可以在段落每行前面加一個(gè)。如果區(qū)塊引用由幾段組成,引用段落之間需要加一個(gè) >
區(qū)分引用不同段落(這是引用標(biāo)記和段落標(biāo)記的組合)。
語法示例:
> This is a blockquote.>> This is the second paragraph in the blockquote.>> ## This is an H2 in a blockquote
一篇文章由N個(gè)段落組成。一個(gè)段落由一個(gè)或多個(gè)連續(xù)的行構(gòu)成,Markdown通過一個(gè)以上的空行區(qū)別不同的段落。只要看起來像空行,不管是由空格符還是tab組成的,一律視為空行。
多個(gè)空格會(huì)被看成一個(gè)空格。一般段落首行沒有縮進(jìn),如果需要首行縮進(jìn)的話可用 
(全方大空白)或  
(半方大空格)。
語法示例:
&emsp 這是段落1這是段落2
Markdown使用星號(hào) *
和底線 _
標(biāo)記強(qiáng)調(diào)區(qū)段。在強(qiáng)調(diào)部分前加上標(biāo)記,在強(qiáng)調(diào)部分結(jié)束后加上標(biāo)記限制強(qiáng)調(diào)范圍。注意星號(hào)強(qiáng)調(diào)標(biāo)志與強(qiáng)調(diào)內(nèi)容之間不能有空格存在,不然變成無序列表了。
語法示例:
*強(qiáng)調(diào)部分變?yōu)樾斌w* 或 _強(qiáng)調(diào)部分變?yōu)樾斌w_**加重強(qiáng)調(diào)部分變?yōu)榇煮w** 或 __加重強(qiáng)調(diào)變?yōu)榇煮w__***特別強(qiáng)調(diào)部分變?yōu)榇中斌w*** 或 ___特別強(qiáng)調(diào)部分變?yōu)榇中斌w___
列表分為無序列表和有序列表兩種。 無序列表使用星號(hào)、加號(hào)、減號(hào)三種中任意一種作為無序列表的項(xiàng)目標(biāo)記。三種符號(hào)可混用,但不建議這樣做。注意列表標(biāo)記和列表項(xiàng)目之間必須至少一個(gè)空格。
語法示例:
* 無序列表中一項(xiàng)* 子項(xiàng),以一個(gè)tab或者4個(gè)空格縮進(jìn)* 無序列表中另一項(xiàng)+ 無序列表另一項(xiàng)- 無序列表另一項(xiàng)
有序列表使用數(shù)字接一個(gè)英文句點(diǎn)作為項(xiàng)目標(biāo)記。注意數(shù)字和句點(diǎn)間不能有空格,句點(diǎn)和項(xiàng)目內(nèi)容之間至少有一個(gè)空格。
語法示例:
1. 有序列表一項(xiàng)2. 有序列表另一項(xiàng)
Markdown支持兩種形式鏈接語法。
行內(nèi)插入鏈接:
[鏈接文字](鏈接地址)示例: [github](http://www.github.com)
參考形式鏈接:類似于文獻(xiàn)中最后列出的參考文獻(xiàn)。
內(nèi)容行內(nèi)插入:
[鏈接文字][鏈接引用標(biāo)簽]
在段落后面或文檔結(jié)尾放上一下內(nèi)容,生成一個(gè)鏈接:
[鏈接引用標(biāo)簽]: 鏈接地址 "鏈接標(biāo)題"
注意其中的冒號(hào)和引號(hào)都是英文符號(hào)。建議鏈接引用標(biāo)簽用數(shù)字表示,可以統(tǒng)計(jì)數(shù)量。 我在github上建立了blog。 1: http://qingu.github.com “github”
圖片引用類似于鏈接引用。圖片可以是網(wǎng)絡(luò)圖片,也可以是本地圖片,本地圖片建議放在source/images目錄中,按年月建立兩層目錄放置便于歸檔。本地圖片的url類似為/images/year/month/img.png。
行內(nèi)形式(title可選):
參考形式:
行內(nèi)引用 ![alt text][id]
段落結(jié)束或文檔結(jié)尾生成一個(gè)圖片引用 [id]: /path/to/img.jpg “title”
語法示例:

效果圖:
兩種選擇,一種是把代碼用反引號(hào) `
括起來。另一種是以制表符或至少 4 個(gè)空格縮進(jìn)的行(常用于代碼段)。本文中白底黑字就是用第一種方法,墨綠色底的代碼塊用的是第二種方法。
要生成水平分割線,可以在單獨(dú)一行里輸入3個(gè)或以上的短橫線(減號(hào))、星號(hào)或者下劃線實(shí)現(xiàn)。短橫線和星號(hào)之間可以輸入任意空格。以下每一行都產(chǎn)生一條水平分割線。
* * **********- - ----------------------
1 http://wowubuntu.com/markdown/basic.html
2 http://http://zh.wikipedia.org/wiki/Markdown
3 http://www.ostools.net/markdown
聯(lián)系客服