Markdown基本語法

最近無心中發現了一款輕量級的標記語言，語法簡單，排版方便，正好最近想學習大數據與機器學習相關的知識，並計劃時常寫一些博客來作筆記，感受Markdown應該是比較適合編輯，因此把博客園的編輯器改爲了markdown,並在之後的記錄中習慣使用。下面就總結一些Markdown的基本語法方便隨時查閱。

1.段落和換行

段落中若是要強制換行，能夠輸入兩個空格鍵加一個回車鍵實現。

2.標題

標題設置有兩種方式
第一種，標題前加 # 號表示，總共分爲六級標題，建議在 # 號後加一個空格，這是最標準的Markdown語法。

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

一級到六級演示效果分別以下：

標題一

標題二

標題三

標題四

標題五

標題六

第二種，經過在文字下方添加 = 或 -，他們分別表示一級標題和二級標題。（任何數量的 = 或 - 效果相同）。

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

效果分別以下：

標題一

標題二

3.區塊引用

若是須要引用一小段別處的句子，那麼就要用引用的格式。

例如這樣

只需在文本前加入 > 這種尖括號（大於號）便可。
區塊引用能夠嵌套（例如：引用內的引用），只要根據層次加上不一樣數量的 > ：

> 應用1
> > 嵌套引用
> 
> 引用2

效果以下：

引用1

嵌套引用

引用2

4.粗體與斜體

Markdown的粗體和斜體也很是簡單，用兩個 * 包含一段文本就是粗體和語法，用一個 * 包含一段文本就是斜體的語法。

**這裏是粗體** *這裏是斜體*

效果爲：這裏是粗體 這裏是斜體

5.列表

Markdown支持有序列表和無序列表。
無序列表只需在文字前加上星號、加號或是減號便可。

* Red
* Green
* Blue

等價於：

+ Red
+ Green
+ Blue

也等價於:

- Red
- Green
- Blue

效果以下：

• Red
• Green
• Blue

有序列表則使用數字接着一個英文句點：

1. Red
2. Green
3. Blue

效果以下：

1. Red
2. Green
3. Blue

6.代碼區塊

代碼區塊中的內容不會進行排版，而是按照原來的樣子顯示。在Markdown中代碼區只要簡單的縮進4個空格或者1個製表符就能夠。

這是一個普通段落：
    
    這是一個代碼區塊。

7.分割線

你能夠在一行中用三個以上的星號、減號、底線來創建一個分割線，行內不能有其餘東西。你也能夠在星號或是減號中間插入空格。下面每種寫法均可以創建分割線：

* * *
***
*****
- - -
——————————————————————————————————————————

會產生兩種效果的分割線，以下顯示：

---

---

——————————————————————————————————————————

8.連接

Markdown中有兩種方式實現連接，分別爲內聯方式和引用方式。無論是哪種，連接文字都是用 [方括號] 來標記。

內聯方式的連接，只要在方塊括號後面緊接着圓括號並插入網址連接便可，若是你還想要加上連接的 title 文字，只要在網址後面，用雙引號把 title 文字包起來便可：

This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.

效果以下：
This is an example inline link.
This link has no title attribute.

若是你是要連接到一樣主機的資源，你可使用相對路徑：

See my [About](/about/) page for details.

引用方式連接，使用另一個方括號接在連接文字的括號後面，而在第二個方括號裏面要填入用以辨識連接的標籤：

This is [an example][id] reference-style link.

也能夠選擇性地在兩個方括號中間加上空白：

This is [an example] [id] reference-style link.

接着，在文檔的任意處，能夠把這個標籤的連接內容定義出來：

[id]: http://example.com/  "Optional Title Here"

連接定義的形式爲：

• 方括號，裏面輸入連接的辨識用標籤
• 接着一個冒號
• 接着一個以上的空白或 tab
• 接着連接的網址
• 選擇性地接着 title 內容，能夠用單引號、雙引號或是括號包着

下面這三種連接的定義都是相同：

[foo]: http://example.com/  "Optional Title Here"   
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

網址定義只有在產生連接的時候用到，並不會直接出如今文檔之中。
示例：

I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].
[1]: http://google.com/        "Google" 
[2]: http://search.yahoo.com/  "Yahoo Search" 
[3]: http://search.msn.com/    "MSN Search"

效果以下：
I get 10 times more traffic from Google than from Yahoo or MSN.

9.程序代碼

若是要標記一小段行內程序代碼，能夠用反引號把它包起來（`），例如：

Use the `printf()` function.

效果爲： Use the printf() function.
若是要在程序代碼區段內插入反引號，能夠用多個反引號來開啓和結束程序代碼區段：

``There is a literal backtick (`) here.``
`` There is a literal backtick (`) here. ``

效果爲：There is a literal backtick (`) here.

10.圖片

Markdown圖片的語法和連接很類似，也分別爲內聯方式和引用方式。
內聯方式圖片的語法看起來像是：

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

詳細敘述以下：

• 一個驚歎號 !
• 接着一個方括號，裏面放上圖片的替換文字
• 接着一個普通括號，裏面放上圖片的網址，最後還能夠用引號包住並加上 選擇性的 'title' 文字。

引用方式圖片語法相似這樣：

![Alt text][id]

「id」是圖片參考的名稱，圖片參考的定義方式則和連接參考同樣：

[id]: url/to/image  "Optional title attribute"

11.自動連接

Markdown 支持比較簡短的自動連接形式來處理網址和電子郵件信箱，只要是用方括號包起來， Markdown 就會自動把它轉成連接，連接的文字就和連接位置同樣，例如：

<http://example.com/>

效果爲: http://example.com/

12.轉義字符

Markdown 能夠利用反斜槓來插入一些在語法中有其它意義的符號，例如：若是想要用星號加在文字旁邊的方式來作出強調效果（但不用 <em> 標籤），能夠在星號的前面加上反斜槓：

\*literal asterisks\*

Markdown 支持在下面這些符號前面加上反斜槓來幫助插入普通的符號：

\   反斜槓
`   反引號
*   星號
_   底線
{}  大括號
[]  方括號
()  括號
#   井字號
+    加號
-    減號
.   英文句點
!   驚歎號

---

編輯器

本人使用的是Window系統，因此選擇了MarkdownPad。

參考文獻

http://daringfireball.net/projects/markdown/basics
http://www.cnblogs.com/hnrainll/p/3514637.html
http://www.ituring.com.cn/article/504
http://www.jianshu.com/p/1e402922ee32/

建議

建議初次接觸Markdown語法的同窗，能夠像我這樣在學習的過程當中嘗試寫一個符合本身查閱習慣的總結，在總結完成之後，也就熟悉了Markdown語法的使用。本篇博客是用Markdown所寫，文章最後會給出源文件下載地址，但願想學習的同窗能夠做爲一個參考。

附件下載