A Simple Markdown Toturial
轉載自:https://github.com/younghz/Markdown
參考: http://wowubuntu.com/markdown/index.html#overview
1.Markdown 是什么?
Markdown 是一種輕量級標記語言, 以純文本形式(易讀、易寫、易更改)編寫文檔,最終以HTML格式發布。Markdown可理解為將以Markdown語法編寫的語言轉換成HTML內容的工具。此外,Markdown 兼容 HTML,意味著可以用 HTML 語法編寫。
2. 如何使用Markdown?
Markdown語法主要分為如下幾大部分:標題,段落,區塊引用,代碼區塊,強調,列表,分割線,鏈接,圖片,反斜杠 \,以及 符號` 等。
2.1 標題
兩種形式:
1)使用 = 和 - 分別標記一級和二級標題。
一級標題
======
效果:
一級標題
二級標題
--------
效果:
二級標題
說明:標題內容與 ===== 或 ------- 之間沒有空行。
2)使用 #,可表示1-6級標題。
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
效果分別如下:
一級標題
二級標題
三級標題
四級標題
五級標題
六級標題
說明:# 需頂格。
2.2 段落
一個 Markdown 段落是由一個或多個連續的文本行組成,它的前后要有一個以上的空行(空行的定義是看起來像是空的,便會被視為空行。例如,若某一行只包含空格和制表符,則該行也會被視為空行)。由一個或多個連續的文本行組成這句話暗示了 Markdown 允許段落內的強迫換行(插入換行符),實現方式是使用兩個以上空格加上回車。普通段落不該用空格或制表符來縮進。
2.3 區塊引用
Markdown 標記區塊引用是使用類似 email 中用 > 的引用方式, 在段落的每行或者只在第一行使用符號 >,還可使用多個嵌套引用,如:
> 區塊引用
>> 嵌套引用
效果:
區塊引用
嵌套引用
2.4 代碼區塊
代碼區塊的建立是通過在每行頂端加上4個空格或者一個制表符(正常代碼基礎上)。
普通段落:
void main()
{
printf("Hello, Markdown.");
}
代碼區塊:
void main()
{
printf("Hello, Markdown.");
}
2.5 強調
在需要強調的內容的兩側分別加上 * 或者 _, 如:
*斜體*, _斜體_
效果:
斜體, 斜體
**粗體**,__粗體__
效果:
粗體,粗體
2.6 列表
Markdown 支持無序列表和有序列表。
無序列表使用 *、+、或者 - 作為列表標記
*(+、-) 第一項
*(+、-) 第二項
*(+、-) 第三項
效果:
- 第一項
- 第二項
- 第三項
有序列表的標記方式是將上述的符號換成數字,并輔以 .,如:
1 . 第一項
2 . 第二項
3 . 第三項
效果:
1 . 第一項
2 . 第二項
3 . 第三項
說明:以上效果加入了區塊引用
2.7 分割線
分割線最常使用就是三個或以上 *,還可以使用 - 和 _。
效果如下:
2.8 鏈接
鏈接可以由兩種形式生成:行內式和參考式。
兩種模式鏈接文字都是用 [方括號] 來標記。
要建立一個行內式的鏈接,只要在方塊括號后面緊接著圓括號并插入網址鏈接即可,如果你還想要加上鏈接的 title 文字,只要在網址后面,用雙引號把 title 文字包起來即可.
行內式:
格式: [words](link) "title" (optional)
[wolf_li 的blog](https://i.cnblogs.com/EditPosts.aspx?postid=8876389) "Markdown"
效果:
wolf_li 的blog "Markdown"
參考式的鏈接是在鏈接文字的括號后面再接上另一個方括號,而在第二個方括號里面要填入用以辨識鏈接的標記:
參考式
格式: [words][id]
[wolf_li 的blog 1][1]
[wolf_li 的blog 2][2]
接著,在文件的任意處,你可以把這個標記的鏈接內容定義出來:
[id]:link "title" (optional)
[1]:https://i.cnblogs.com/EditPosts.aspx?postid=8876389 "Markdown1"
[2]:https://i.cnblogs.com/EditPosts.aspx?postid=8876389 "Markdown2"
效果:
wolf_li 的blog 1
wolf_li 的blog 2
2.9 圖片
添加圖片的形式和鏈接相似,只需在鏈接格式的前面加一個!。

2.10 反斜杠 \
相當于反轉義作用,使符號成為普通符號。
2.11 符號 `
起到標記作用。如:
`ctrl+a`
效果:
ctrl+a
其它:
列表的使用:
- 第一行為表頭,第二行分隔表頭和主體部分,第三行開始每一行代表一個表格行;
- 用
|表示表格縱向邊界,表頭和表內容用-隔開; - 用
:進行對齊設置,-右邊加:表示右對齊,兩邊都有:則表示居中,若不加:則默認左對齊。
示例:
代碼庫 | 鏈接
:-: | :-:
Makedown | https://i.cnblogs.com/EditPosts.aspx?postid=8876389
MakedownCopy | https://i.cnblogs.com/EditPosts.aspx?postid=8876389
效果:
| 代碼庫 | 鏈接 |
|---|---|
| Makedown | https://i.cnblogs.com/EditPosts.aspx?postid=8876389 |
| MakedownCopy | https://i.cnblogs.com/EditPosts.aspx?postid=8876389 |
實踐:
掌握一個知識最好的辦法是實踐,如果沒有合適的實踐項目,可以實現上述內容。
浙公網安備 33010602011771號