內(nèi)容包含
- 區(qū)塊元素
- 段落和換行
- 標(biāo)題
- 區(qū)塊引用
- 列表
- 代碼區(qū)塊
- 分隔線
- 區(qū)段元素
- 鏈接
- 強(qiáng)調(diào)
- 代碼
- 圖片
- 其他
- 自動(dòng)鏈接
- 反斜杠
區(qū)塊元素
段落和換行
段落之間需要有一個(gè)或者多個(gè)空行來分隔
這里就是第二段
第二段
段內(nèi)換行，需要兩個(gè)空格加一個(gè)回車
標(biāo)題
用 # 號(hào)來處理表示 H1
兩個(gè) # 號(hào)來表示 H2
以此類推, 如
# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
顯示如下:
一級(jí)標(biāo)題
二級(jí)標(biāo)題
三級(jí)標(biāo)題
區(qū)塊引用
引用一個(gè)區(qū)塊，用 > 來表示
如
> 這里是區(qū)塊引用的內(nèi)容
效果如下:
這里是區(qū)塊引用的內(nèi)容
區(qū)塊引用可以嵌套，如
> 這里是外層引用
>> 內(nèi)層引用多加一個(gè) > 符號(hào)
>>> 再內(nèi)層
效果如下:
這里是外層引用
內(nèi)層引用多加一個(gè) > 符號(hào)
再內(nèi)層
列表
列表分為 無序列表 和 有序列表
無序列表
無序列表是在文本前加 * 號(hào)
如
* 無序列表項(xiàng)1
* 無序列表項(xiàng)2
* 無序列表項(xiàng)3
* 無序列表項(xiàng)4
效果如下:
- 無序列表項(xiàng)1
- 無序列表項(xiàng)2
- 無序列表項(xiàng)3
- 無序列表項(xiàng)4
有序列表
有序列表是在文本前加 1. 2. 3.
如:
1. 有序列表項(xiàng)1
2. 有序列表項(xiàng)2
3. 有序列表項(xiàng)3
4. 有序列表項(xiàng)4
效果如下:
- 有序列表項(xiàng)1
- 有序列表項(xiàng)2
- 有序列表項(xiàng)3
- 有序列表項(xiàng)4
代碼區(qū)塊
代碼區(qū)塊是在文本后空一行，在縮進(jìn)4個(gè)空格
這里就是代碼區(qū)塊
代碼區(qū)塊里的文本不會(huì)解析MarkDown語(yǔ)法，如 *沒有強(qiáng)調(diào)效果*
## 沒有標(biāo)題效果
代碼區(qū)塊在沒有縮進(jìn)的文本時(shí)就結(jié)束了
分隔線
以下方法都可以表示分隔線
* * *
***
*****
- - -
---------------------------------------
區(qū)段元素
鏈接
鏈接分為行內(nèi)式和參考式兩種
行內(nèi)式
用 [] 把需要鏈接的文本包含起來，然后在其后面用小括號(hào)包含URL
如
百度的首頁(yè):[百度](https://www.baidu.com)
效果如下:
百度的首頁(yè): 百度
參考式
參考式先用 [文本][資源id] 的形式占位，然后在其他地方指定URL，后面的 資源id 可以省略，會(huì)把文本當(dāng)做id
如
百度的首頁(yè): [百度][baidu] 或 [百度][]
在其他空白的地方定義百度的URL，形如
[baidu]: https://www.baidu.com "百度首頁(yè)"
[百度]: https://www.baidu.com "百度首頁(yè)"
后面的字符串只是一個(gè)描述
效果如下
百度的首頁(yè): 百度baidu
百度的首頁(yè): 百度
強(qiáng)調(diào)
用 一對(duì) ** 符號(hào) 或者 __ 符號(hào)把需要強(qiáng)調(diào)的詞包含起來
如
這里有一個(gè) *重要的會(huì)議* ,請(qǐng)_準(zhǔn)時(shí)_參加
效果如下
這里有一個(gè)重要的會(huì)議,請(qǐng) 準(zhǔn)時(shí) 參加
代碼
段落中的代碼
在一段文本段落中，用一對(duì) ` 號(hào)把代碼包含起來
如
在Swift語(yǔ)言中，打印函數(shù)是`print()`
如打印Hello World! 就這樣 `print("Hello World!")`
效果如下
在Swift語(yǔ)言中，打印函數(shù)是print()
如打印Hello World! 就這樣 print("Hello World!")
一段代碼
如果要單獨(dú)引入一段代碼，可以用一對(duì)三個(gè) ` 符號(hào)把一段代碼包含在內(nèi)
如
```Swift // 這里可以語(yǔ)法高亮的語(yǔ)言
// 這里用for循環(huán)打印10次Hello World!
for _ in 1...10 {
print("Hello World!")
}
```
效果如下
// 這里用for循環(huán)打印10次Hello World!
for _ in 1...10 {
print("Hello World!")
}
圖片
引入圖片也有行內(nèi)式和參考式兩種，目前MarkDown還沒有指定圖片寬高的方法,如果需要用<img>標(biāo)簽
行內(nèi)式
和鏈接類似，只是在鏈接的形式前加了個(gè) ! 號(hào)
如
效果如下
參考式
參考式和鏈接類似，也可以先占位，然后在其他地方指定圖片的URL
如
// 后面的括號(hào)指定ID
![Cat][catURL]
![Dog][dogURL]
// 也可以把簡(jiǎn)寫ID，會(huì)把文本當(dāng)成ID
![Cat2][]
![Dog2][]
// 在其他位置指定id的對(duì)應(yīng)的URL
[catURL]: http://upload-images.jianshu.io/upload_images/4300331-91f2633dc312cf64.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
[dogURL]: http://upload-images.jianshu.io/upload_images/4300331-d9174e22144e9505.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
[Cat2]: http://upload-images.jianshu.io/upload_images/4300331-91f2633dc312cf64.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
[Dog2]: http://upload-images.jianshu.io/upload_images/4300331-d9174e22144e9505.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
效果如下
其他
自動(dòng)鏈接
MarkDown支持用簡(jiǎn)短的形式來表示網(wǎng)址和郵箱，只需要用<>把網(wǎng)址和郵箱地址包含起來
如
百度地址<https://www.baidu.com>
給我發(fā)郵件<dancewithpeng@gmail.com>
效果如下
百度地址https://www.baidu.com
給我發(fā)郵件dancewithpeng@gmail.com
反斜杠
可以用反斜杠在MarkDown文檔中表示的字符
\ 反斜線
` 反引號(hào)
* 星號(hào)
_ 底線
{} 花括號(hào)
[] 方括號(hào)
() 括弧
# 井字號(hào)
+ 加號(hào)
- 減號(hào)
. 英文句點(diǎn)
! 驚嘆號(hào)