markdown簡明語法

收藏自：http://ibruce.info/2013/11/26/markdown/

Markdown是一種極簡的『標記語言』，將文本轉為HTML，通常為我大碼農所用。其不追求大而全，簡潔至上，正所謂不求最貴，只求最好！

本文介紹Markdown基本語法，內容很少，一行語法一行示例，學會后可輕松寫出高大上的文檔，再也不需要各種編輯器去調文章格式。另外，網上有 各平台下的Markdown工具可用，也有在線的，我直接使用sublime搞定，Markdown本來就是為了追求簡潔，弄個工具豈不多此一舉。

強調

---

星號與下划線都可以，單是斜體，雙是粗體，符號可跨行，符號可加空格

**一個人來到田納西**

__毫無疑問__
*我做的餡餅
是全天下*
_最好吃的_

一個人來到田納西

毫無疑問
我做的餡餅
是全天下
最好吃的

分割線

---

三個或更多-_*，必須單獨一行，可含空格

---

引用

---

翻譯成html就是<blockquote></blockquote>，符號后的空格可不要

> 引用

引用

內層符號前的空格必須要

>引用
 >>引用中的引用

引用

引用中的引用

標題：Setext方式

---

三個或更多

大標題
===
小標題
---

大標題

小標題

標題：Atx方式

---

#一級標題
##二級標題
###三級標題
####四級標題
#####五級標題
######六級標題

一級標題

二級標題

三級標題

四級標題

五級標題

六級標題

無序列表

---

符號之后的空格不能少，-+*效果一樣，但不能混合使用，因混合是嵌套列表，內容可超長

- 無序列表
- 無序列表
- 無序列表
- 無序列表：我很長。我也很長！那比一比啊？比就比！我有這么長，你有我長嗎？我有這么這么長！好吧，你贏了！

• 無序列表
• 無序列表
• 無序列表
• 無序列表：我很長。我也很長！那比一比啊？比就比！我有這么長，你有我長嗎？我有這么這么長！好吧，你贏了！

符號之后的空格不能少，-+*效果一樣，但不能混合使用，因混合是嵌套列表

+ 無序列表
+ 無序列表
+ 無序列表

• 無序列表
• 無序列表
• 無序列表

符號之后的空格不能少，-+*效果一樣，但不能混合使用，因混合是嵌套列表

* 無序列表
* 無序列表
* 無序列表

• 無序列表
• 無序列表
• 無序列表

有序列表

---

數字不能省略但可無序，點號之后的空格不能少

1. 有序列表
2. 有序列表
3. 有序列表
8. 有序列表

1. 有序列表
2. 有序列表
3. 有序列表
4. 有序列表

嵌套列表

---

-+*可循環使用，但符號之后的空格不能少，符號之前的空格也不能少

- 嵌套列表
 + 嵌套列表
 + 嵌套列表
 - 嵌套列表
 * 嵌套列表
- 嵌套列表

• 嵌套列表
  • 嵌套列表
  • 嵌套列表
    • 嵌套列表
      • 嵌套列表
• 嵌套列表

文字超鏈：Inline方式

---

Tooltips可省略

[不如](http://bruce-sha.github.io "不如的博客")

不如

圖片超鏈

---

多個感嘆號，Tooltips可省略，要設置大小只能借助HTML標記

![GitHub Mark](http://github.global.ssl.fastly.net/images/modules/logos_page/GitHub-Mark.png "GitHub Mark")

GitHub Mark

索引超鏈：Reference方式

---

索引，1 2可以是任意字符

[不如][1]
![GitHub Octocat][2]

[1]:http://bruce-sha.github.io
[2]:http://github.global.ssl.fastly.net/images/modules/logos_page/Octocat.png

不如
GitHub Octocat

自動鏈接

---

尖括號

<http://ibruce.info>
<[e-mail]>

http://ibruce.info

[e-mail]

---

代碼：行內代碼

---

在第一行后指定編程語言，也可以不指定

<!--0-->

val s = "hello Markdown"
println( s )

代碼：段落代碼

---

每行文字前加4個空格或者1個Tab

val s = "hello Markdown"
println( s )

val s = "hello Markdown" println( s ) 

代碼：hexo

---

可指定編程語言，『』代表左右大括號

『% codeblock [title] [lang:language] [url] [link text] %』
 code snippet
『% endcodeblock %』

注釋

---

用html的注釋，好像只有這樣？

<!-- 注釋 -->

轉義字符

---

用html的注釋，好像只有這樣？

Markdown中的轉義字符為\，轉義的有：
\\ 反斜杠
\` 反引號
\* 星號
\_ 下划線
\{\} 大括號
\[\] 中括號
\(\) 小括號
\# 井號
\+ 加號
\- 減號
\. 英文句號
\! 感嘆號

其它

---

文本中可直接用html標簽，但是要前后加上空行。

one more thing：表格

---

Markdown的擴展語法，hexo不支持

|| *Year* || *Temperature (low)* || *Temperature (high)* ||
|| 1900 || -10 || 25 ||
|| 1910 || -15 || 30 ||
|| 1920 || -10 || 32 ||

結束語

---

以上基本夠用，更詳盡的請參考文獻10，另外Markdown+R可以干大事，請參考文獻7。

參考文獻

---

1. Markdown 簡明語法
2. Markdown之表格的處理
3. 獻給寫作者的 Markdown 新手指南
4. Cmd Markdown 編輯閱讀器
5. Markdown語法說明（詳解版）
6. 怎樣使用Markdown
7. Markdown寫作淺談
8. Markdown語法示例
9. HTML轉義字符對照表
10. Markdown 語法說明(簡體中文版)