Markdown通用的經常使用語法說明

前言

Markdown 是一種輕量級的 標記語言，語法簡潔明瞭、學習容易，還具備其餘不少優勢，目前被愈來愈多的人用來寫做使用。

Markdown具備一系列衍生版本，用於擴展Markdown的功能（如表格、腳註、內嵌HTML等等），這些功能原初的Markdown尚不具有，它們能讓Markdown轉換成更多的格式，例如LaTeX，Docbook。Markdown加強版中比較有名的有Markdown Extra、MultiMarkdown、 Maruku等。這些衍生版本要麼基於工具，如Pandoc；要麼基於網站，如GitHub和Wikipedia，在語法上基本兼容，但在一些語法和渲染效果上有改動。

因爲一些擴展只在特定的環境中才能實現，因此這裏介紹的是通用的經常使用語法說明。

語法

下面就是經常使用的Markdown語法內容，以標準Markdown語法爲依據，可能這裏有一些差別，請以語法爲準。

標題

標題分爲6級，對應HTML標籤的h1~h6。#越多，字體越小。

# H1標題
## H2標題
### H3標題
#### H4標題
##### H5標題
###### H6標題

H1標題

H2標題

H3標題

H4標題

H5標題

H6標題

---

分隔符

分隔符就是一條橫線。

---

---

文本樣式

斜體

* 斜體文本 *
_ 斜體文本 _

斜體文本 斜體文本

粗體

加粗就是是文字爲粗體顯示，可使用下面兩中方式表示：

**粗體文本**
__粗體文本__

粗體文本

粗體文本

斜粗體

***斜粗體文本*** *__斜粗體文本__*
_**斜粗體文本**_ ___斜粗體文本___

斜粗體文本 斜粗體文本

斜粗體文本 斜粗體文本

刪除線

文字有一條刪除線的效果

~~ 刪除效果 ~~

刪除效果

高亮

文字用醒目的高亮顯示

這是` 高亮文本 `效果。

這是高亮文本效果。

代碼塊

代碼塊就是將源碼直接進行展現，可在開始的 ``` 後面加上代碼語種名稱。

`` `  javascript
var str = "hello world!";
alert(str);
`` `

爲了顯示，上面給出的 ``` 加了一個空格。

var str = "hello world!";
alert(str);

上面就是效果

圖片

圖片展現

方式1：
![文本內容](https://help.github.com/assets/images/site/favicon.ico "logo")
方式2：
![文本內容][img]
[img]:https://help.github.com/assets/images/site/favicon.ico "logo"

方式1：

方式2：

說明：

URL後面的內容是鼠標hover提示文本，能夠省略，省略時就沒有鼠標hover提示文本效果。

推薦使用方式2，當一個連接在文中屢次出現的時候，就會體現出其優勢了。

另外，後面的提示文本除了使用 "提示文本" 外，還能夠是 '提示文本' 和 (提示文本) 。

[id]:URL "鼠標hover提示文本"
[id]:URL '鼠標hover提示文本'
[id]:URL (鼠標hover提示文本)

連接

連接根據連接目標可分爲站內站外連接，按照類型可分爲文本連接和圖片連接。
綜上所述，可分爲如下三種：

文本連接

給文本信息添加超連接

1.<https://github.com/SeayXu>
2.[文本連接](https://github.com/SeayXu "SeayXu")
3.[文本連接][id]
[id]:https://github.com/SeayXu "SeayXu"

1.https://github.com/SeayXu
2.文本連接
3.文本連接

連接URL相關說明和圖片同樣，請查看

特例：
當連接的文本內容和連接Id相同的時候，能夠不用寫連接後面的Id。

[SeayXu][]
[SeayXu]:https://github.com/SeayXu "Seay"

SeayXu

圖片連接

給圖片加上超連接

方式1：
[![Github](https://help.github.com/assets/images/site/favicon.ico "Seay")](https://github.com/SeayXu  "SeayXu")
方式2：
[![Github][img-url]][link-url]
[link-url]:https://github.com/SeayXu "SeayXu"
[img-url]:https://help.github.com/assets/images/site/favicon.ico "Seay"

方式1：

方式2：

提示：因爲各個Markdown解析不一樣，因此顯示的提示文本有可能也不太同樣。

錨點

錨點其實與文本連接和圖片連接用法是同樣的，只不過是在本頁面內，須要稍微改動下。

設置錨點連接目標：

<h6 id="url-more">說明：</h6>

添加錨點：

[錨點](#url-more "anchor alt text")
[錨點][anchor]
[anchor]:#url-more "anchor alt text"

錨點
錨點

說明：相對於文本連接和圖片連接，主要是添加了錨點連接目標這一操做，使用語法跟文本連接和圖片連接同樣。

列表

列表分爲有序和無序兩種。

無序列表

無序列表有三種表示方法： * 、 + 和 -。

下級在上級基礎上前面多加兩個空格，符號與內容直接有一個空格。

無序列表1：

* 一級條目1
* 一級條目2
  * 二級條目1
  * 二級條目2
    * 三級條目1
    * 三級條目2
    * 三級條目3
  * 二級條目3
* 一級條目3

• 一級條目1
• 一級條目2
  • 二級條目1
  • 二級條目2
    • 三級條目1
    • 三級條目2
    • 三級條目3
  • 二級條目3
• 一級條目3

在這裏只演示一種，另外兩種就是把 * 分別換成 + 和 - 。

有序列表

有序列表與無序列表相似，只不是是將前面的符號換成數字而已。

1. 一級條目1
2. 一級條目2
  1. 二級條目1
  * 二級條目2
    * 三級條目1
    + 三級條目2
    - 三級條目3
  - 二級條目3
2. 一級條目3

1. 一級條目1
2. 一級條目2
3. 二級條目1

• 二級條目2
  • 三級條目1
  • 三級條目2
  • 三級條目3
• 二級條目3

1. 一級條目3

說明：

1. 有序列表有自動糾錯功能，當序號輸入錯誤時，會自動更正顯示序號。
2. 有序列表可結合無序列表，只在第一個條目輸入序號後，同級條目會自動編號。

引用

引用內容能夠嵌套引用和使用其餘語法，在引用內容後面空一行就表示引用結束。

>這是一段包含**加粗**的 _斜體_ 和 _**斜粗體**_ 並帶有`高亮`顯示的一段文原本自[個人Github](https://github.com/SeayXu "SeayXu")。
我是圖片：
![github logo][github-img]
[github-url]:https://github.com/SeayXu "SeayXu"

這是一段包含加粗的 斜體 和 斜粗體 並帶有高亮顯示的一段文原本自個人Github。
我是圖片：

本文來自：markdown-general-common-syntax 本文就介紹到這裏，若有不足之處，可隨時與我聯繫。