PS(2016.04): 三年前最開始學(xué)習(xí) markdown 的時(shí)候記錄的筆記,最近在重新整理之前的筆記乎完,再次翻起與 markdown 相關(guān)的一系列筆記辱揭,這里重新整理一下。
基礎(chǔ)語(yǔ)法規(guī)則
行內(nèi)文字格式化
- 加粗:用兩個(gè)
*
包裹文字即可忍疾,粗體。 - 斜體:用一個(gè)
*
包裹文字即可谨朝,斜體卤妒。 - 粗斜體:用三個(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)文字然后用文字鏈接的方式就可以了士复。
段落與換行
在 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
- 無(wú)序列表1
- 無(wú)序
- 無(wú)序列表2
如果列表之間加了空行,就會(huì)被解釋成兩段內(nèi)容们何,也許得到的就并不是你想要的了萄焦。
代碼塊
代碼塊分兩種镀钓,內(nèi)聯(lián)代碼及塊代碼柄沮,對(duì)應(yīng)于 HTML 中的 code
和 pre
標(biāo)簽。內(nèi)聯(lián)代碼很簡(jiǎn)單廷粒,用 ` 號(hào)(鍵盤上數(shù)字 1 左邊那個(gè)鍵)包裹起來(lái)即可贴见。而塊代碼則有兩種方式:
使用三個(gè) ` 來(lái)包裹代碼塊烘苹,這種方式可以自定義語(yǔ)法高亮
-
將代碼塊向右縮進(jìn)四個(gè)空格,這種方式不會(huì)帶任何語(yǔ)法高亮
```javascript console.log('hello world'); ```
這時(shí)片部,你看到的效果會(huì)是:
console.log('hello world');
分隔線
當(dāng)一行元素為 * * *
的時(shí)候镣衡,就是下面這種效果的分隔線了:
-
角注 ?