【精選】Markdown 語法彙總

博客園也能Markdown？美滋滋，Markdown真的是好用QAQ。
本文檔按照Markdown各類經常使用語法類別，以文字描述+演示的方式來展示markdown語法的使用。Markdown 的目標是實現[易讀易寫]，成爲一種適用於網絡的書寫語言。HTML 是一種發佈的格式，Markdown 是一種書寫的格式，Markdown 的格式語法只涵蓋純文本能夠涵蓋的範圍，Markdown 語法兼容HTML語法。

段落和換行

一個 Markdown 段落是由一個或多個連續的文本行組成，它的先後要有一個以上的空行。普通的Markdown 段落不能夠用空格或製表符來縮進。

空行：一行以內只包含回車換行、空格、製表符。

標題

Markdown 支持兩種標題的語法，類 Setext 和類 atx 形式。

(1)類 Setext 形式

類 Setext 形式語法是使用用標題下底線的形式，包括 = （一級標題）和 - （二級標題），任何數量的 = 和 - 均可以有效果。 例如：

一級標題下加=

二級標題下加-

(2)類 atx 形式

類 Atx 形式則是在行首插入 1 到 6 個 # ，#和標題文字之間使用一個或多個空格，對應到標題 1 到 6 級， 例如：

這是 H1

這是 H2

這是 H3

強調

Markdown 使用星號（*）和下滑線（_）做爲標記強調字詞的符號，例如：

斜體
加粗

可是若是你的*和 _ 兩邊都有空白的話，它們就只會被當成普通的符號。若是要在文字先後直接插入普通的星號或下劃線，你能夠用反斜線： 例如： 使用反斜線開頭的被當作是普通的字符*

區塊引用

Markdown 標記區塊引用的方法是在行的最前面加 > ，也能夠只在整個段落的第一行最前面加上 >，區塊引用內部能夠嵌套，只要根據層次加上不一樣數量的 >便可，引用的區塊內也可使用其餘的 Markdown 語法，包括標題、列表、代碼區塊等。 例如:

Markdown 標記區塊引用的方法是在行的最前面加> 也能夠只在整個段落的第一行最前面加上 >

區塊引用內部能夠嵌套，只要根據層次加上不一樣數量的 >便可.我是內部嵌套區塊，我可使用其餘Markdown 語法哦

我是引用區塊內使用標題3語法

在引用區塊內能夠加入代碼塊 import java.net.URL; import java.util.Arrays; import java.util.Date; import java.util.Set;

列表

Markdown 支持有序列表和無序列表，無序列表使用星號、加號或是減號做爲列表標記，有序列表則使用數字接着一個英文句點。兩種列表方式格式都是：列表標記+空格+列表項，即列表項目標記一般是放在最左邊，也能夠縮進最多 3 個空格，項目標記後面則必定要接着至少一個空格或製表符。

(1)無序列表

星號、加號或是減號三種列表方式效果等同。 例如：

*Red

*Green

*Blue

星號列表

*   Red
*   Green
*   Blue

加號列表

*Red
*Green
*Blue

減號列表

*Red
*Green
*Blue

(2)有序列表

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

1.Red

2.Green

3.Blue

代碼塊
同各類程序語言相關的寫做或是標籤語言原始碼一般會有已經排版好的代碼塊，一般這些代碼塊咱們並不但願它以通常段落的方式去排版，而是照原來的樣子顯示。 Markdown創建代碼塊的方法：只要在行最前面簡單地縮進 4 個空格或是 1 個製表符就能夠，一個代碼區塊會一直持續到沒有縮進的那一行。

這是一個代碼區塊。
只要簡單地縮進 4 個空格或是 1 個製表符就能夠
一個代碼區塊會一直持續到沒有縮進的那一行

小段代碼

須要引用代碼時，若是引用的語句只有一段，不分行，能夠用 ` 將語句包起來。 若是引用的語句爲多行，能夠將```置於這段代碼的首行和末行。

​```cpp
#include<iostream>
​```

分隔線

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

* * *

***

*****

- - -

---------------------------------------

---

---

---

---

---

連接

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

[行內式連接標題](https://www.cnblogs.com/gongdakai/)

圖片

Markdown 使用一種和連接很類似的語法來標記圖片。

行內式的圖片語法以下：   詳細敘述以下： 一個驚歎號 ! 接着一個方括號，裏面放上圖片的替代文字，接着一個普通括號，裏面放上圖片的網址，最後還能夠用引號包住並加上 選擇性的 'title' 文字。

自動連接

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

反斜槓

Markdown 能夠利用反斜槓來插入一些在語法中有其它意義的符號，例如：若是你想要用星號加在文字旁邊的方式來作出強調效果，你能夠在星號的前面加上反斜槓： Markdown 支持如下這些符號前面加上反斜槓來幫助插入普通的符號：

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