一、前言
之前有了解過markdown，但一直沒實際使用，今天試用了下，感覺很爽，推薦給大家，特別是在編寫規范、接口文檔等方面非常適合，因為其簡單易用也有很多人用來寫網絡小說。
二、介紹
Markdown 的目標是實現易讀易寫，可以直接在問編輯器書寫和保存，除本身具有非常好的可讀寫外，還可以生存格式非常好看的html代碼發布在互聯網中。
如鏈接：腳本之家，其書寫格式為：
[腳本之家](https://www.jb51.net/)
Markdown 不是想要取代 HTML，甚至也沒有要和它相近，它的語法種類很少，只對應 HTML 標記的一小部分。Markdown 的構想不是要使得 HTML 文檔更容易書寫。在我看來， HTML 已經很容易寫了。Markdown 的理念是，能讓文檔更容易讀、寫和隨意改。HTML 是一種發布的格式，Markdown 是一種書寫的格式。就這樣，Markdown 的格式語法只涵蓋純文本可以涵蓋的范圍。
三、語法介紹
（一）區塊元素
段落和換行
一個 Markdown 段落是由一個或多個連續的文本行組成，它的前后要有一個以上的空行（空行的定義是顯示上看起來像是空的，便會被視為空行。比方說，若某一行只包含空格和制表符，則該行也會被視為空行）。普通段落不該用空格或制表符來縮進。
「由一個或多個連續的文本行組成」這句話其實暗示了 Markdown 允許段落內的強迫換行（按入兩個以上的空格然后回車）
標題
Markdown 支持兩種標題的語法，類 Setext 和類 [atx][2] 形式，我們這里只介紹我建議使用的Atx 形式. 類 Atx 形式則是在行首插入 1 到 6 個 # ，對應到標題 1 到 6 階,例如：
復制代碼 代碼如下:
# 這是H1
## 這是 H2
###### 這是H6
區塊引用 Blockquotes
Markdown 標記區塊引用是使用類似 email 中用 > 的引用方式,如：
復制代碼 代碼如下:
>這是一個區塊引用
>這是一個區塊引用
展現形式為：
這是一個區塊引用
這是一個區塊引用
列表
Markdown 支持有序列表和無序列表。
無序列表使用星號、加號或是減號作為列表標記：如：
復制代碼 代碼如下:
* Red
* Green
* Blue
有序列表則使用數字接著一個英文句點：
復制代碼 代碼如下:
1. Bird
2. McHale
3. Parish
代碼區塊
這功能應該是我們程序員最喜歡的功能，在 Markdown 中建立代碼區塊很簡單，只要簡單地縮進 4 個空格或是 1 個制表符就可以，有些還支持代碼高亮。
復制代碼 代碼如下:
分隔線
你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線，行內不能有其他東西。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線：
復制代碼 代碼如下:
* * *
***
*****
- - -
---------------------------------------
（二）區段元素
鏈接
Markdown 支持兩種形式的鏈接語法： 行內式和參考式兩種形式
不管是哪一種，鏈接文字都是用 [方括號] 來標記。
這里只介紹行內式，參考式可以訪問本文后面的參考鏈接詳細了解。
要建立一個行內式的鏈接，只要在方塊括號后面緊接著圓括號并插入網址鏈接即可，如果你還想要加上鏈接的 title 文字，只要在網址后面，用雙引號把 title 文字包起來即可，例如：
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
強調
Markdown 使用星號（*）和底線（_）作為標記強調字詞的符號，被 * 或 _ 包圍的字詞會被轉成用 em> 標簽包圍，用兩個 * 或 _ 包起來的話，則會被轉成 strong>，例如：
復制代碼 代碼如下:
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
代碼
如果要標記一小段行內代碼，你可以用反引號把它包起來（`），例如：
則會被轉成 `strong>`
圖片
很明顯地，要在純文字應用中設計一個「自然」的語法來插入圖片是有一定難度的。 Markdown 使用一種和鏈接很相似的語法來標記圖片，同樣也允許兩種樣式： 行內式和參考式。 這里也只介紹行內式：
復制代碼 代碼如下:
詳細敘述如下：
一個驚嘆號 !
接著一個方括號，里面放上圖片的替代文字
接著一個普通括號，里面放上圖片的網址，最后還可以用引號包住并加上 選擇性的 ‘title' 文字。
（三）其它
自動鏈接
Markdown 支持以比較簡短的自動鏈接形式來處理網址和電子郵件信箱，只要是用方括號包起來， Markdown 就會自動把它轉成鏈接。一般網址的鏈接文字就和鏈接地址一樣，例如：
復制代碼 代碼如下:
http://example.com/>
address@example.com>
Markdown 會轉為：
復制代碼 代碼如下:
a >http://example.com//a>
a href="mailto:address@example.com">address@example.com/a>
反斜杠
Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強調效果（但不用 em> 標簽），你可以在星號的前面加上反斜杠： literal asterisks Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號：
復制代碼 代碼如下:
\&; 反斜線
` 反引號
* 星號
_ 底線
{} 花括號
[] 方括號
() 括弧
# 井字號
+ 加號
- 減號
. 英文句點
! 驚嘆號
markdown編輯器
markdown的編輯器基本都支持實時預覽功能，下面介紹幾個我在用的。
1.我自己在用的woidows markdown編輯器是markdownpad 2,覺還不錯
2.在線編輯器有mahua
3.wordpress編輯器：wp-markdown
參考鏈接
Markdown 語法說明 (簡體中文版):http://wowubuntu.com/markdown/
您可能感興趣的文章:- CommonMark 使用教程：將 Markdown 語法轉成 Html
- Markdown語法備忘
- VSCODE配置Markdown及Markdown基礎語法詳解
