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