markdown基礎語法

轉自github

主要內容

Markdown是_什麼_？

_誰_發明了這麼個東西？

_爲何_要使用它？

_怎麼_使用？

都_誰_在用？####

感受有意思？不怕你看見，就怕你試試

正文

1. Markdown是什麼？

Markdown是一種輕量級標記語言，它以純文本形式(易讀、易寫、易更改)編寫文檔，並最終以HTML格式發佈。
Markdown也能夠理解爲將以MARKDOWN語言編寫的語言轉換成HTML內容的工具，最初是一個perl腳本_Markdown.pl_。

2. _誰_發明了這麼個東西？

它由Aaron Swartz和John Gruber共同設計，Aaron Swartz就是那位於去年（2013年1月11日）自殺,有着開掛通常人生經歷的程序員。維基百科對他的介紹是：軟件工程師、做家、政治組織者、互聯網活動家、維基百科人。

他有着足以讓你跪拜的人生經歷：

• 14歲參與RSS 1.0規格標準的制訂。
• 2004年入讀斯坦福，以後退學。
• 2005年建立Infogami，以後與Reddit合併成爲其合夥人。
• 2010年創立求進會（Demand Progress），積極參與禁止網絡盜版法案（SOPA）活動，最終該提案竟然被撤回。
• 2011年7月19日，因被控從MIT和JSTOR下載480萬篇學術論文並以避免費形式上傳於網絡被捕。
• 2013年1月自殺身亡。

天才都有早逝的歸途（又是一位猶太人）。

3. _爲何_要使用它？

• 它是易讀（看起開舒服）、易寫（語法簡單）、易更改純文本。到處體現着極簡主義的影子。
• 兼容HTML，能夠轉換爲HTML格式發佈。
• 跨平臺使用。
• 愈來愈多的網站支持Markdown。
• 更方便清晰的組織你的電子郵件。（Markdown-here, Airmail）
• 擺脫Word（我不是認真的）。

4. _怎麼_使用？

若是不算擴展，Markdown的語法絕對簡單到讓你愛不釋手。

廢話太多，下面正文，Markdown語法主要分爲以下幾大部分： 標題，段落，區塊引用，代碼區塊，強調，列表，分割線，連接，圖片，反斜槓 \，符號'`'。

4.1 標題

兩種形式：
1）使用=和-標記一級和二級標題。

一級標題
=========
二級標題
---------

效果：

一級標題

二級標題

2）使用#，可表示1-6級標題。

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

效果：

一級標題

二級標題

三級標題

四級標題

五級標題

六級標題

4.2 段落

段落的先後要有空行，所謂的空行是指沒有文字內容。若想在段內強制換行的方式是使用兩個以上空格加上回車（引用中換行省略回車）。

4.3 區塊引用

在段落的每行或者只在第一行使用符號>,還可以使用多個嵌套引用，如：

> 區塊引用
>> 嵌套引用

效果：

區塊引用

嵌套引用

4.4 代碼區塊

代碼區塊的創建是在每行加上4個空格或者一個製表符（如同寫代碼同樣）。如
普通段落：

void main()
{
printf("Hello, Markdown.");
}

代碼區塊：

void main()
{
    printf("Hello, Markdown.");
}

注意:須要和普通段落之間存在空行。

4.5 強調

在強調內容兩側分別加上*或者_，如：

*斜體*，_斜體_
**粗體**，__粗體__

效果：

斜體，斜體
粗體，粗體

4.6 列表

使用·、+、或-標記無序列表，如：

-（+*） 第一項 -（+*） 第二項 - （+*）第三項

注意：標記後面最少有一個_空格_或_製表符_。若不在引用區塊中，必須和前方段落之間存在空行。

效果：

• 第一項
• 第二項
• 第三項

有序列表的標記方式是將上述的符號換成數字,並輔以.，如：

1 . 第一項
2 . 第二項
3 . 第三項

效果：

1. 第一項
2. 第二項
3. 第三項

4.7 分割線

分割線最常使用就是三個或以上*，還可使用-和_。

4.8 連接

連接能夠由兩種形式生成：行內式和參考式。
行內式：

[younghz的Markdown庫](https:://github.com/younghz/Markdown "Markdown")。

效果：

younghz的Markdown庫。

參考式：

[younghz的Markdown庫1][1]
[younghz的Markdown庫2][2]
[1]:https:://github.com/younghz/Markdown "Markdown"
[2]:https:://github.com/younghz/Markdown "Markdown"

效果：

younghz的Markdown庫1
younghz的Markdown庫2

注意：上述的[1]:https:://github.com/younghz/Markdown "Markdown"不出如今區塊中。

4.9 圖片

添加圖片的形式和連接類似，只需在連接的基礎上前方加一個！。

4.10 反斜槓\

至關於反轉義做用。使符號成爲普通符號。

4.11 符號'`'

起到標記做用。如：

`ctrl+a`

效果：

ctrl+a

5. 都_誰_在用？####

Markdown的使用者：

• GitHub
• 簡書
• Stack Overflow
• Apollo
• Moodle
• Reddit
• 等等

6. 感受有意思？趁熱打鐵，推薦幾個_工具_。

• Chrome下的stackedit插件能夠離線使用，很爽。也不用擔憂平臺受限。 在線的dillinger.io算是評價好的了，但是不能離線使用。
• Windowns下的MarkdownPad也用過，不過免費版的體驗不是很好。
• Mac下的Mou是國人貢獻的，口碑很好。推薦。
• Linux下的ReText不錯。

其實在對語法瞭如於心的話，直接用編輯器就能夠了，腦子裏滿滿的都是格式化好的文本啊。 我如今使用馬克飛象 + Markdown-here，先編輯好，而後一鍵格式化，挺方便。

---

注意：不一樣的Markdown解釋器或工具對相應語法（擴展語法）的解釋效果不盡相同，具體可參見工具的使用說明。 雖然有人想出面搞一個所謂的標準化的Markdown，[沒想到還惹怒了健在的創始人John Gruber] (http://blog.codinghorror.com/standard-markdown-is-now-common-markdown/)。

---

以上基本是全部traditonal markdown的語法。

其它：

列表的使用(非traditonal markdown)：

用|表示表格縱向邊界，表頭和表內容用-隔開，並可用:進行對齊設置，兩邊都有:則表示居中，若不加:則默認左對齊。

代碼庫	連接
MarkDown	https://github.com/younghz/Markdown
moos-young	https://github.com/younghz/moos-young

關於其它擴展語法可參見具體工具的使用說明。