說明：現(xiàn)在markDown編譯器和各平臺支持情況都不太統(tǒng)一，為了達(dá)到一些效果會使用語法超集，但有些平臺支持不好，請自行裁剪。簡書使用的精簡語法集合，文中有些語法效果顯示不出來，為了發(fā)文的格式統(tǒng)一，同時也建議謹(jǐn)慎使用此類語法。

一、概述

1.1 設(shè)計理念

• Markdown 易于閱讀，方便創(chuàng)作web文檔，利于各平臺無縫分發(fā)。
• Markdown 語法靈感最大的來源還是純文本 email 的格式，完全由標(biāo)點(diǎn)符號標(biāo)簽組成的純文本。
• Markdown 文件應(yīng)該以純文本形式原樣發(fā)布，不應(yīng)該包含標(biāo)記標(biāo)簽和格式化指令。

1.2 內(nèi)聯(lián) HTML 語法

• HTML 是一種發(fā)布格式，Markdown 是一種創(chuàng)作格式。
• Markdown語法集合比較小，只是HTML標(biāo)簽的一小部分。
• 對于 Markdown 中未包含的標(biāo)簽, 可以直接使用 HTML標(biāo)簽，例如用 HTML <a> 標(biāo)簽替代 Markdown 的鏈接語法。

1.3 特殊字符自動轉(zhuǎn)義

??在 HTML 中, 有兩個字符需要特殊對待: < 和 &，左尖括號用于起始標(biāo)簽。如果你想將它們用作字面量, 你必須將它們轉(zhuǎn)義為字符實體, 例如< 和 &。

二、行內(nèi)語法講解

2.1 注釋的表述

• 代碼法

• html注釋

既然支持html語法，那也支持html注釋，快捷鍵 comment + /。

<!--哈哈我是注釋，不會在瀏覽器中顯示。--><!--哈哈我是多段注釋，不會在瀏覽器中顯示。    -->

• hack方法

hack方法就是利用markdown的解析原理來實現(xiàn)注釋的。
一般有的markdown解析器不支持上面的注釋方法，這個時候就可以用hack方法。
hack方法比上面2種方法穩(wěn)定得多，但是語義化太差。

2.2 分級標(biāo)題、任務(wù)列表

• 分級標(biāo)題

# 一級標(biāo)題## 二級標(biāo)題### 三級標(biāo)題#### 四級標(biāo)題##### 五級標(biāo)題###### 六級標(biāo)題  <!--最多6級標(biāo)題-->

由于用了標(biāo)記編輯器會把所有標(biāo)題寫到目錄大綱中，在這里寫的演示標(biāo)題也會列進(jìn)去，所以就不演示了。同學(xué)們自己在編輯器中觀察，很簡單，一級標(biāo)題字號最大，依級遞減。

• 任務(wù)列表

Markdown 語法：

效果如下：

• 任務(wù)一 未做任務(wù) - + 空格 + [ ]
• 任務(wù)二 已做任務(wù) - + 空格 + [x]

2.3 縮進(jìn)、換行、空行、對齊方式

• 首行縮進(jìn)

不同特殊占位符所占空白是不一樣大的。

【1】  或  //全角【2】  或  //半角【3】  或   //半角之半角

• 換行

由于markdown編輯器的不同,可能在一行字后面，直接換行回車，也能實現(xiàn)換行，但是在Visual Studio Code上，想要換行必須得在一行字后面空兩個格子才行。

• 空行

在編輯的時候有多少個空行(只要這一行只有回車或者space沒有其他的字符就算空行)，在渲染之后，只隔著一行。

• 對齊方式

代碼：

顯示效果：

<center>行中心對齊</center>
<p align='left'>行左對齊</p>
<p align='right'>行右對齊</p>

2.4 斜體、粗體、刪除線、下劃線、背景高亮

• 代碼：

*斜體*或_斜體_**粗體*****加粗斜體***~~刪除線~~++下劃線++==背景高亮==

• 顯示效果：

??斜體 ??粗體 ??加粗斜體 ??刪除線 ??++刪除線++ ??==背景高亮==

2.5 超鏈接、頁內(nèi)鏈接、自動鏈接、注腳

• 行內(nèi)式

語法說明：

[]里寫鏈接文字，()里寫鏈接地址, ()中的''中可以為鏈接指定title屬性，title屬性可加可不加。title屬性的效果是鼠標(biāo)懸停在鏈接上會出現(xiàn)指定的 title文字，鏈接地址與title前有一個空格。

代碼：

顯示效果：

歡迎閱讀 擇勢勤

• 參考式

參考式超鏈接一般用在學(xué)術(shù)論文上面，或者另一種情況，如果某一個鏈接在文章中多處使用，那么使用引用 的方式創(chuàng)建鏈接將非常好，它可以讓你對鏈接進(jìn)行統(tǒng)一的管理。

語法說明：
參考式鏈接分為兩部分，文中的寫法 [鏈接文字][鏈接標(biāo)記]，在文本的任意位置添加[鏈接標(biāo)記]:鏈接地址。

如果鏈接文字本身可以做為鏈接標(biāo)記，你也可以寫成[鏈接文字][]
[鏈接文字]：鏈接地址的形式，見代碼的最后一行。

代碼：

我經(jīng)常去的幾個網(wǎng)站[Google][1]、[Leanote][2]。[1]:http://www.google.com [2]:http://www.leanote.com

顯示效果：

我經(jīng)常去的幾個網(wǎng)站Google、Leanote。

• 注腳

語法說明：

在需要添加注腳的文字后加上腳注名字[^注腳名字],稱為加注。 然后在文本的任意位置(一般在最后)添加腳注，腳注前必須有對應(yīng)的腳注名字。

注意：經(jīng)測試注腳與注腳之間必須空一行，不然會失效。成功后會發(fā)現(xiàn)，即使你沒有把注腳寫在文末，經(jīng)Markdown轉(zhuǎn)換后，也會自動歸類到文章的最后。

代碼：

顯示效果：

使用 Markdown^[1]可以效率的書寫文檔, 直接轉(zhuǎn)換成 HTML^[2]。

注：腳注自動被搬運(yùn)到最后面，請到文章末尾查看，腳注后方的鏈接可以直接跳轉(zhuǎn)回到加注的地方。

• 錨點(diǎn)（頁內(nèi)超鏈接）

網(wǎng)頁中，錨點(diǎn)其實就是頁內(nèi)超鏈接，也就是鏈接本文檔內(nèi)部的某些元素，實現(xiàn)當(dāng)前頁面中的跳轉(zhuǎn)。比如我這里寫下一個錨點(diǎn)，點(diǎn)擊回到目錄，就能跳轉(zhuǎn)到目錄。 在目錄中點(diǎn)擊這一節(jié)，就能跳過來。還有下一節(jié)的注腳。這些根本上都是用錨點(diǎn)來實現(xiàn)的，只支持在標(biāo)題后插入錨點(diǎn)，其它地方無效。

代碼：

## 0. 目錄{#index}

顯示效果：

跳轉(zhuǎn)到目錄

• 自動鏈接

語法說明：
Markdown 支持以比較簡短的自動鏈接形式來處理網(wǎng)址和電子郵件信箱，只要是用<>包起來， Markdown 就會自動把它轉(zhuǎn)成鏈接。一般網(wǎng)址的鏈接文字就和鏈接地址一樣，例如：

代碼：

顯示效果：

<http:///> ??
<address@>

2.6 無序列表、有序列表、定義型列表

• 無序列表
  使用 *，+，- 表示無序列表。
  代碼：

* 無序列表項 一+ 無序列表項 二- 無序列表項 三

顯示效果：

• 無序列表項 一

• 無序列表項 二

• 無序列表項 三

• 有序列表

有序列表則使用數(shù)字接著一個英文句點(diǎn)。
代碼：

顯示效果：

1. 有序列表項 一
2. 有序列表項 二
3. 有序列表項 三

• 定義型列表表

語法說明：

定義型列表由名詞和解釋組成。一行寫上定義，緊跟一行寫上解釋。解釋的寫法:緊跟一個縮進(jìn)(Tab)

代碼

:   輕量級文本標(biāo)記語言（左側(cè)有一個可見的冒號和四個不可見的空格）

顯示效果：

Markdown
: 輕量級文本標(biāo)記語言，可以轉(zhuǎn)換成html，pdf等格式

2.7 插入圖像

語法中圖片Alt的意思是如果圖片因為某些原因不能顯示，就用定義的圖片Alt文字來代替圖片。 圖片Title則和鏈接中的Title一樣，表示鼠標(biāo)懸停與圖片上時出現(xiàn)的文字。 Alt 和 Title 都不是必須的，可以省略，但建議寫上。

Markdown 語法：

效果如下：

GitHub set up

2.8 多級引用

語法說明：

引用需要在被引用的文本前加上>符號和空格，允許多層嵌套，也允許你偷懶只在整個段落的第一行最前面加上 > 。

代碼：

>>> 請問 Markdwon 怎么用？ - 小白>> 自己看教程！ - 憤青> 教程在哪？ - 小白

顯示效果：

請問 Markdwon 怎么用？ - 小白

自己看教程！ - 憤青

教程在哪？ - 小白

2.9 轉(zhuǎn)義字符、字體、字號、顏色

• 轉(zhuǎn)義字符

Markdown中的轉(zhuǎn)義字符為\，轉(zhuǎn)義的有：

\ 反斜杠?` 反引號?* 星號?_ 下劃線?{} 大括號?[] 中括號?() 小括號? # 井號?+ 加號?- 減號?. 英文句號?! 感嘆號

• 字體、字號、顏色

代碼：

顯示效果：

<font face='黑體'>我是黑體字</font>
<font face='微軟雅黑'>我是微軟雅黑</font>
<font face='STCAIYUN'>我是華文彩云</font>
<font color=#0099ff size=12 face='黑體'>黑體</font>
<font color=gray size=5>gray</font>
<font color=#00ffff size=3>null</font>

三、塊語法講解

3.1 內(nèi)容目錄

在段落中填寫 [TOC] 以顯示全文內(nèi)容的目錄結(jié)構(gòu)。

[TOC]

效果參見最上方的目錄。

3.2 代碼塊

對于程序員來說這個功能是必不可少的，插入程序代碼的方式有兩種，一種是利用縮進(jìn)(Tab), 另一種是利用”`”符號（一般在ESC鍵下方）包裹代碼。

• 行內(nèi)式

代碼：

顯示效果：

C語言里的函數(shù) scanf() 怎么使用？

• 縮進(jìn)式多行代碼

縮進(jìn) 4 個空格或是 1 個制表符

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

代碼：

#include <stdio.h>int main(void){    printf(&#34;Hello world\n&#34;);}

顯示效果：

• 用六個`包裹多行代碼

代碼：

、、、include <stdio.h>int main(void){printf('Hello world\n');}、、、

顯示效果：

3.3 流程圖

編輯自有道云筆記，代碼：

```graph LRA-->B``````sequenceDiagramA->>B: How are you?B->>A: Great!```

顯示效果：

sequenceDiagramA->>B: How are you?B->>A: Great!

3.4 表格

語法說明：

不管是哪種方式，第一行為表頭，第二行分隔表頭和主體部分，第三行開始每一行為一個表格行。
列于列之間用管道符|隔開。原生方式的表格每一行的兩邊也要有管道符。
第二行還可以為不同的列指定對齊方向。默認(rèn)為左對齊，在-右邊加上:就右對齊。
- 左對齊， :-: 中心對齊，-: 右對齊

表格代碼：

原生方式寫表格：
<center>

</center>

3.5 LaTeX 公式

• 表示行內(nèi)公式

代碼：

質(zhì)能守恒方程可以用一個很簡潔的方程式 `$E = m c^2 $`來表達(dá)。

顯示效果：

質(zhì)能守恒方程可以用一個很簡潔的方程式 $E = m c^2 $來表達(dá)。

• 表示整行公式
  大部分的瀏覽器支持的

有道云筆記 使用格式，

```mathE = mc^2```

塊級公式：

顯示效果：

x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} 

訪問 MathJax 參考更多使用方法。

3.6 分隔線

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

代碼：

* * *********- - ------------

顯示效果都一樣：

3.7 HTML 原始碼

在代碼區(qū)塊里面， & 、 < 和 > 會自動轉(zhuǎn)成 HTML 實體，這樣的方式讓你非常容易使用 Markdown 插入范例用的 HTML 原始碼，只需要復(fù)制貼上，剩下的 Markdown 都會幫你處理，例如：

代碼：

顯示效果：

第一個例子：
<div class='footer'>
? 2004 Foo Corporation
</div>

第二個例子：

<center>

<table>
<tr>
<th rowspan='2'>值班人員</th>
<th>星期一</th>
<th>星期二</th>
<th>星期三</th>
</tr>
<tr>
<td>李強(qiáng)</td>
<td>張明</td>
<td>王平</td>
</tr>
</table>

</center>

3.8 特殊字

<center>

</center>

版權(quán)歸屬 ?2019 擇勢勤

1. Markdown是一種純文本標(biāo)記語言 ?

2. HyperText Markup Language 超文本標(biāo)記語言 ?