MarkDown標(biāo)記語(yǔ)言語(yǔ)法

PS(2016.04): 三年前最開始學(xué)習(xí) markdown 的時(shí)候記錄的筆記,最近在重新整理之前的筆記乎完,再次翻起與 markdown 相關(guān)的一系列筆記辱揭,這里重新整理一下。

基礎(chǔ)語(yǔ)法規(guī)則

行內(nèi)文字格式化

  1. 加粗:用兩個(gè) * 包裹文字即可忍疾,粗體
  2. 斜體:用一個(gè) * 包裹文字即可谨朝,斜體卤妒。
  3. 粗斜體:用三個(gè) * 包裹文字即可,粗斜體字币。

角注

角注使用[^1]這種方式添加[1]则披。具體使用方式如下:

引用角注[^1]

[^1]: 角注內(nèi)容

圖片和鏈接

  • 自動(dòng)鏈接:<http://example.com/> 得到的是 http://example.com/
  • 帶文字鏈接:[蘑菇街](http://www.mogujie.com) 得到的就是 蘑菇街

向頁(yè)面中插入圖片的方式與帶文字鏈接類似,只不過(guò)前面多了個(gè)感嘆號(hào):

![當(dāng)圖片出不來(lái)顯示的文字](http://upload-images.jianshu.io/upload_images/2283-476c245df0fe29fa.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
當(dāng)圖片出不來(lái)顯示的文字

圖片上帶鏈接洗出?只要圖片整體當(dāng)文字然后用文字鏈接的方式就可以了士复。

段落與換行

在 HTML 頁(yè)面中,段落使用 <p></p> 標(biāo)簽包裹翩活,而換行則使用 <br />阱洪。在 Markdown 的語(yǔ)法中,段落直接使用空行隔開即可菠镇,而段內(nèi)換行則是行最后跟兩個(gè)空格冗荸,再換到下一行繼續(xù)書寫。示例如下:

我是一段文字

我是一段文字利耍,但我下面還有段內(nèi)換行文字  
哈哈蚌本,我是段內(nèi)換行的文字,你會(huì)發(fā)現(xiàn)上一行最后還有兩個(gè)空格哦隘梨!

我是一段文字

我是一段文字程癌,但我下面還有段內(nèi)換行文字
哈哈,我是段內(nèi)換行的文字出嘹,你會(huì)發(fā)現(xiàn)上一行最后還有兩個(gè)空格哦席楚!

標(biāo)題

標(biāo)題是每篇文章都需要也是最常用的格式咬崔,在 Markdown 中税稼,如果一段文字被定義為標(biāo)題,只要在這段文字前加 # 號(hào)即可垮斯。幾級(jí)標(biāo)題加幾個(gè) # 號(hào)郎仆。示例如下:

# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題

注:不推薦無(wú)節(jié)制地加標(biāo)題,每個(gè)項(xiàng)目最好提前約定好標(biāo)題級(jí)數(shù)的使用規(guī)范兜蠕。

引用區(qū)塊

在 HTML 頁(yè)面中扰肌,引用區(qū)塊使用的是 blockquote 標(biāo)簽,Markdown 語(yǔ)法提供了一種更方便的方式熊杨,效果其實(shí)前面的中已經(jīng)展現(xiàn)了曙旭,在要引用的段文字最前加 >即可盗舰。(如果有多段,則每一段最前都要加)

> 我是引用內(nèi)容
>
> 我也是引用內(nèi)容

我是引用內(nèi)容

我也是引用內(nèi)容

列表

列表包括有序列表和無(wú)序列表桂躏,有序列表用數(shù)字開頭钻趋,而無(wú)序列表使用 *-+ 開頭,之后跟一個(gè)空格再添加內(nèi)容剂习,子列表需要相對(duì)父列表向右多兩個(gè)空格且不能加空行蛮位。示例如下:

無(wú)序列表:

 - 無(wú)序列表1
   + 無(wú)序子列表
 - 無(wú)序列表2
  • 無(wú)序列表1
    • 無(wú)序子列表
  • 無(wú)序列表2

有序列表:(事實(shí)上,只要是數(shù)字就行鳞绕,無(wú)需關(guān)注順序失仁,即便先寫 2 再寫 1 最終得到的也是按順序排列的列表)

2. 有序列表1
  a. 有序子列表
1. 有序列表2
  1. 無(wú)序列表1
  • 無(wú)序
  1. 無(wú)序列表2

如果列表之間加了空行,就會(huì)被解釋成兩段內(nèi)容们何,也許得到的就并不是你想要的了萄焦。

代碼塊

代碼塊分兩種镀钓,內(nèi)聯(lián)代碼及塊代碼柄沮,對(duì)應(yīng)于 HTML 中的 codepre 標(biāo)簽。內(nèi)聯(lián)代碼很簡(jiǎn)單廷粒,用 ` 號(hào)(鍵盤上數(shù)字 1 左邊那個(gè)鍵)包裹起來(lái)即可贴见。而塊代碼則有兩種方式:

  1. 使用三個(gè) ` 來(lái)包裹代碼塊烘苹,這種方式可以自定義語(yǔ)法高亮

  2. 將代碼塊向右縮進(jìn)四個(gè)空格,這種方式不會(huì)帶任何語(yǔ)法高亮

     ```javascript
     console.log('hello world');
     ```    
    

這時(shí)片部,你看到的效果會(huì)是:

console.log('hello world');

分隔線

當(dāng)一行元素為 * * * 的時(shí)候镣衡,就是下面這種效果的分隔線了:



  1. 角注 ?

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市档悠,隨后出現(xiàn)的幾起案子廊鸥,更是在濱河造成了極大的恐慌,老刑警劉巖辖所,帶你破解...
    沈念sama閱讀 216,372評(píng)論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件惰说,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡缘回,警方通過(guò)查閱死者的電腦和手機(jī)吆视,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,368評(píng)論 3 392
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)酥宴,“玉大人啦吧,你說(shuō)我怎么就攤上這事∽竟眩” “怎么了授滓?”我有些...
    開封第一講書人閱讀 162,415評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我般堆,道長(zhǎng)在孝,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,157評(píng)論 1 292
  • 正文 為了忘掉前任淮摔,我火速辦了婚禮浑玛,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘噩咪。我一直安慰自己顾彰,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,171評(píng)論 6 388
  • 文/花漫 我一把揭開白布胃碾。 她就那樣靜靜地躺著涨享,像睡著了一般。 火紅的嫁衣襯著肌膚如雪仆百。 梳的紋絲不亂的頭發(fā)上厕隧,一...
    開封第一講書人閱讀 51,125評(píng)論 1 297
  • 那天,我揣著相機(jī)與錄音俄周,去河邊找鬼吁讨。 笑死,一個(gè)胖子當(dāng)著我的面吹牛峦朗,可吹牛的內(nèi)容都是我干的建丧。 我是一名探鬼主播,決...
    沈念sama閱讀 40,028評(píng)論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼波势,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼翎朱!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起尺铣,我...
    開封第一講書人閱讀 38,887評(píng)論 0 274
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤拴曲,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后凛忿,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體澈灼,經(jīng)...
    沈念sama閱讀 45,310評(píng)論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,533評(píng)論 2 332
  • 正文 我和宋清朗相戀三年店溢,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了叁熔。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,690評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡逞怨,死狀恐怖者疤,靈堂內(nèi)的尸體忽然破棺而出福澡,到底是詐尸還是另有隱情叠赦,我是刑警寧澤,帶...
    沈念sama閱讀 35,411評(píng)論 5 343
  • 正文 年R本政府宣布,位于F島的核電站除秀,受9級(jí)特大地震影響糯累,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜册踩,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,004評(píng)論 3 325
  • 文/蒙蒙 一泳姐、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧暂吉,春花似錦胖秒、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至肮街,卻和暖如春风题,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背嫉父。 一陣腳步聲響...
    開封第一講書人閱讀 32,812評(píng)論 1 268
  • 我被黑心中介騙來(lái)泰國(guó)打工沛硅, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人绕辖。 一個(gè)月前我還...
    沈念sama閱讀 47,693評(píng)論 2 368
  • 正文 我出身青樓摇肌,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親仪际。 傳聞我的和親對(duì)象是個(gè)殘疾皇子朦蕴,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,577評(píng)論 2 353

推薦閱讀更多精彩內(nèi)容