概述

1、兼容HTML

HTML是一種發(fā)布的格式，Markdown是一種發(fā)布的格式。Markdown 語法在 HTML 區(qū)段標(biāo)簽間是有效的。

Markdown 的生成器有足夠智能，不會在 HTML 區(qū)塊標(biāo)簽外加上不必要的

標(biāo)簽。

例：
這是一個(gè)普通段落。

<table>

<tr>

<td>1</td>

</tr>

</table>

這是另一個(gè)普通段落。

1.1表格

（作者：熱心市民123
鏈接：http://m.itdecent.cn/p/59aaa82ae723
來源：簡書
簡書著作權(quán)歸作者所有，任何形式的轉(zhuǎn)載都請聯(lián)系作者獲得授權(quán)并注明出處。）

表格前一定要空一行
在每個(gè)單元格文字的兩端加上一個(gè)豎線“|”。
第二行控制單元格文本的位置，第二行控制文本的位置，規(guī)則如下：默認(rèn)是靠左，用英文冒號“:”來調(diào)整，兩邊都有冒號，而且冒號中間至少有一個(gè)減號“-”的時(shí)候表示居中（當(dāng)然也可以通過增加“-”號的數(shù)目來使它們對齊，更好看一點(diǎn)，但效果是一樣的）；冒號在右邊而且冒號之前至少有一個(gè)-的時(shí)候表示靠右，其它情況則是靠左。注意，冒號“:”一定要為英文的，不可為中文的冒號。如：

2、特殊字符自動轉(zhuǎn)換

在 HTML 文件中，有兩個(gè)字符需要特殊處理： < 和 & 。 < 符號用于起始標(biāo)簽，& 符號則用于標(biāo)記 HTML 實(shí)體，如果你只是想要顯示這些字符的原型，你必須要使用實(shí)體的形式，像是 ＆lt和 &amp。

注意：code 范圍內(nèi)，不論是行內(nèi)還是區(qū)塊， < 和 & 兩個(gè)符號都一定會被轉(zhuǎn)換成 HTML 實(shí)體，這項(xiàng)特性讓你可以很容易地用 Markdown 寫 HTML code ；而HTML 語法中，要把所有的 < 和 & 都轉(zhuǎn)換為 HTML 實(shí)體，才能在 HTML 文件里面寫出 HTML code。

二、區(qū)塊元素

1.段落和段行

2.標(biāo)題

Markdown 支持兩種標(biāo)題的語法，類 Setext 和類 atx 形式。

類 Setext ：是用底線的形式，利用 = （最高階標(biāo)題）和 - （第二階標(biāo)題）

例：This is an H1

=============

This is an H2

類 atx ：在行首插入 1 到 6 個(gè) # ，對應(yīng)到標(biāo)題 1 到 6 階

例：
這是 H1 #

這是 H2 ##

這是 H3 ######

3.區(qū)塊引用

在每行的最前面加上 > ；在整個(gè)段落的第一行最前面加上 > ；區(qū)塊引用可以嵌套（例如：引用內(nèi)的引用），只要根據(jù)層次加上不同數(shù)量的 > ；引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語法，包括標(biāo)題、列表、代碼區(qū)塊等；

例：

這是一個(gè)標(biāo)題。

1. 這是第一行列表項(xiàng)。

2. 這是第二行列表項(xiàng)。

給出一些例子代碼：

return shell_exec("echo markdown_script");

4.列表

無序列表：使用星號、加號或是減號作為列表標(biāo)記

有序列表：使用數(shù)字接著一個(gè)英文句點(diǎn)（數(shù)字的正確性不用在意）

例：

1. 好

2. 哈

注意：列表項(xiàng)目可以包含多個(gè)段落，每個(gè)項(xiàng)目下的段落都必須縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符：；列表要放代碼區(qū)塊的話，該區(qū)塊就需要縮進(jìn)兩次，也就是 8 個(gè)空格或是 2 個(gè)制表符

5.代碼區(qū)塊

縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符；一個(gè)代碼區(qū)塊會一直持續(xù)到?jīng)]有縮進(jìn)的那一行（或是文件結(jié)尾）。

6.分割線

在一行中用三個(gè)以上的星號、減號、底線來建立一個(gè)分隔線，行內(nèi)不能有其他東西。也可以在星號或是減號中間插入空格：

三、區(qū)段元素

1.鏈接

鏈接文字都是用 [方括號] 來標(biāo)記。

鏈接內(nèi)容定義的形式為：

方括號（前面可以選擇性地加上至多三個(gè)空格來縮進(jìn)），里面輸入鏈接文字

接著一個(gè)冒號

接著一個(gè)以上的空格或制表符

接著鏈接的網(wǎng)址

選擇性地接著 title 內(nèi)容，可以用單引號、雙引號或是括弧包著

2.強(qiáng)調(diào)

Markdown 使用星號（*）和底線（_）作為標(biāo)記強(qiáng)調(diào)字詞的符號，被 * 或 _ 包圍的字詞會被轉(zhuǎn)成用 標(biāo)簽包圍，用兩個(gè) * 或 _ 包起來的話，則會被轉(zhuǎn)成<strong>

例：

single asterisks

single underscores

double asterisks

double underscores

會轉(zhuǎn)成：

single asterisks

single underscores

double asterisks

double underscores

注意：*和_兩邊不能都有空白，否則會被當(dāng)作普通符號

3.代碼

標(biāo)記一小段行內(nèi)代碼，可以用反引號把它包起來（`）

4.圖片

行內(nèi)式：

[圖片上傳失敗...(image-94cbbd-1535548389219)]

[圖片上傳失敗...(image-4ccdee-1535548389219)]

詳細(xì)敘述如下：

一個(gè)驚嘆號 !

接著一個(gè)方括號，里面放上圖片的替代文字

接著一個(gè)普通括號，里面放上圖片的網(wǎng)址，最后還可以用引號包住并加上 選擇性的 'title' 文字。

參考式：

Alt text

「id」是圖片參考的名稱，圖片參考的定義方式則和連結(jié)參考一樣：

四、補(bǔ)充

1.反斜杠

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

\ 反斜線

` 反引號

• 星號

_ 底線

{} 花括號

[] 方括號

() 括弧

井字號

• 加號

• 減號

. 英文句點(diǎn)

! 驚嘆號

2.自動鏈接

支持以比較簡短的自動鏈接形式來處理網(wǎng)址和電子郵件信箱，只要是用方括號包起來， Markdown 就會自動把它轉(zhuǎn)成鏈接。

五、Markdown 免費(fèi)編輯器

1.Windows 平臺

Markdownpad

Markpad

2.Linux 平臺

Retext

Mac 平臺

Mou

3.在線編輯器

Markable.in

Dillinger.io

4.瀏覽器插件

MaDe(Chrome)