
說明:現(xiàn)在markDown編譯器和各平臺(tái)支持情況都不太統(tǒng)一,為了達(dá)到一些效果會(huì)使用語法超集,但有些平臺(tái)支持不好,請(qǐng)自行裁剪。簡(jiǎn)書使用的精簡(jiǎn)語法集合,文中有些語法效果顯示不出來,為了發(fā)文的格式統(tǒng)一,同時(shí)也建議謹(jǐn)慎使用此類語法。
[TOC]
一、概述
1.1 設(shè)計(jì)理念
- Markdown 易于閱讀,方便創(chuàng)作web文檔,利于各平臺(tái)無縫分發(fā)。
- Markdown 語法靈感最大的來源還是純文本 email 的格式,完全由標(biāo)點(diǎn)符號(hào)標(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)簽的一小部分。
- 對(duì)于 Markdown 中未包含的標(biāo)簽, 可以直接使用 HTML標(biāo)簽,例如用 HTML
<a>標(biāo)簽替代 Markdown 的鏈接語法。
1.3 特殊字符自動(dòng)轉(zhuǎn)義
??在 HTML 中, 有兩個(gè)字符需要特殊對(duì)待: < 和 &,左尖括號(hào)用于起始標(biāo)簽。如果你想將它們用作字面量, 你必須將它們轉(zhuǎn)義為字符實(shí)體, 例如< 和 &。
二、行內(nèi)語法講解
2.1 注釋的表述
- 代碼法
<div style='display: none'>
哈哈我是注釋,不會(huì)在瀏覽器中顯示。
</div>
- html注釋
既然支持html語法,那也支持html注釋,快捷鍵 comment + /。
<!--哈哈我是注釋,不會(huì)在瀏覽器中顯示。-->
<!--
哈哈我是多段注釋,
不會(huì)在瀏覽器中顯示。
-->
- hack方法
hack方法就是利用markdown的解析原理來實(shí)現(xiàn)注釋的。
一般有的markdown解析器不支持上面的注釋方法,這個(gè)時(shí)候就可以用hack方法。
hack方法比上面2種方法穩(wěn)定得多,但是語義化太差。
[//]: # (哈哈我是最強(qiáng)注釋,不會(huì)在瀏覽器中顯示。)
[^_^]: # (哈哈我是最萌注釋,不會(huì)在瀏覽器中顯示。)
[//]: <> (哈哈我是注釋,不會(huì)在瀏覽器中顯示。)
[comment]: <> (哈哈我是注釋,不會(huì)在瀏覽器中顯示。)
2.2 分級(jí)標(biāo)題、任務(wù)列表
- 分級(jí)標(biāo)題
# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題
##### 五級(jí)標(biāo)題
###### 六級(jí)標(biāo)題 <!--最多6級(jí)標(biāo)題-->
由于用了標(biāo)記編輯器會(huì)把所有標(biāo)題寫到目錄大綱中,在這里寫的演示標(biāo)題也會(huì)列進(jìn)去,所以就不演示了。同學(xué)們自己在編輯器中觀察,很簡(jiǎn)單,一級(jí)標(biāo)題字號(hào)最大,依級(jí)遞減。
- 任務(wù)列表
Markdown 語法:
- [ ] 任務(wù)一 未做任務(wù) `- + 空格 + [ ]`
- [x] 任務(wù)二 已做任務(wù) `- + 空格 + [x]`
效果如下:
- 任務(wù)一 未做任務(wù)
- + 空格 + [ ] - 任務(wù)二 已做任務(wù)
- + 空格 + [x]
2.3 縮進(jìn)、換行、空行、對(duì)齊方式
- 首行縮進(jìn)
不同特殊占位符所占空白是不一樣大的。
【1】  或  //全角
【2】  或  //半角
【3】 或  //半角之半角
- 換行
由于markdown編輯器的不同,可能在一行字后面,直接換行回車,也能實(shí)現(xiàn)換行,但是在Visual Studio Code上,想要換行必須得在一行字后面空兩個(gè)格子才行。
- 空行
在編輯的時(shí)候有多少個(gè)空行(只要這一行只有回車或者space沒有其他的字符就算空行),在渲染之后,只隔著一行。
- 對(duì)齊方式
代碼:
<center>行中心對(duì)齊</center>
<p align="left">行左對(duì)齊</p>
<p align="right">行右對(duì)齊</p>
顯示效果:
<center>行中心對(duì)齊</center>
<p align="left">行左對(duì)齊</p>
<p align="right">行右對(duì)齊</p>
2.4 斜體、粗體、刪除線、下劃線、背景高亮
- 代碼:
*斜體*或_斜體_
**粗體**
***加粗斜體***
~~刪除線~~
++下劃線++
==背景高亮==
- 顯示效果:
??斜體 ??粗體 ??加粗斜體 ??刪除線 ??++刪除線++ ??==背景高亮==
2.5 超鏈接、頁內(nèi)鏈接、自動(dòng)鏈接、注腳
- 行內(nèi)式
語法說明:
[]里寫鏈接文字,()里寫鏈接地址, ()中的""中可以為鏈接指定title屬性,title屬性可加可不加。title屬性的效果是鼠標(biāo)懸停在鏈接上會(huì)出現(xiàn)指定的 title文字,鏈接地址與title前有一個(gè)空格。
代碼:
歡迎閱讀 [擇勢(shì)勤](http://www.itdecent.cn/u/16d77399d3a7 "擇勢(shì)勤")
顯示效果:
歡迎閱讀 擇勢(shì)勤
- 參考式
參考式超鏈接一般用在學(xué)術(shù)論文上面,或者另一種情況,如果某一個(gè)鏈接在文章中多處使用,那么使用引用 的方式創(chuàng)建鏈接將非常好,它可以讓你對(duì)鏈接進(jìn)行統(tǒng)一的管理。
語法說明:
參考式鏈接分為兩部分,文中的寫法 [鏈接文字][鏈接標(biāo)記],在文本的任意位置添加[鏈接標(biāo)記]:鏈接地址。
如果鏈接文字本身可以做為鏈接標(biāo)記,你也可以寫成[鏈接文字][]
[鏈接文字]:鏈接地址的形式,見代碼的最后一行。
代碼:
我經(jīng)常去的幾個(gè)網(wǎng)站[Google][1]、[Leanote][2]。
[1]:http://www.google.com
[2]:http://www.leanote.com
顯示效果:
我經(jīng)常去的幾個(gè)網(wǎng)站Google、Leanote。
- 注腳
語法說明:
在需要添加注腳的文字后加上腳注名字[^注腳名字],稱為加注。 然后在文本的任意位置(一般在最后)添加腳注,腳注前必須有對(duì)應(yīng)的腳注名字。
注意:經(jīng)測(cè)試注腳與注腳之間必須空一行,不然會(huì)失效。成功后會(huì)發(fā)現(xiàn),即使你沒有把注腳寫在文末,經(jīng)Markdown轉(zhuǎn)換后,也會(huì)自動(dòng)歸類到文章的最后。
代碼:
使用 Markdown[^1]可以效率的書寫文檔, 直接轉(zhuǎn)換成 HTML[^2]。
[^1]:Markdown是一種純文本標(biāo)記語言
[^2]:HyperText Markup Language 超文本標(biāo)記語言
顯示效果:
使用 Markdown[1]可以效率的書寫文檔, 直接轉(zhuǎn)換成 HTML[2]。
注:腳注自動(dòng)被搬運(yùn)到最后面,請(qǐng)到文章末尾查看,腳注后方的鏈接可以直接跳轉(zhuǎn)回到加注的地方。
- 錨點(diǎn)(頁內(nèi)超鏈接)
網(wǎng)頁中,錨點(diǎn)其實(shí)就是頁內(nèi)超鏈接,也就是鏈接本文檔內(nèi)部的某些元素,實(shí)現(xiàn)當(dāng)前頁面中的跳轉(zhuǎn)。比如我這里寫下一個(gè)錨點(diǎn),點(diǎn)擊回到目錄,就能跳轉(zhuǎn)到目錄。 在目錄中點(diǎn)擊這一節(jié),就能跳過來。還有下一節(jié)的注腳。這些根本上都是用錨點(diǎn)來實(shí)現(xiàn)的,只支持在標(biāo)題后插入錨點(diǎn),其它地方無效。
代碼:
## 0. 目錄{#index}
顯示效果:
跳轉(zhuǎn)到目錄
- 自動(dòng)鏈接
語法說明:
Markdown 支持以比較簡(jiǎn)短的自動(dòng)鏈接形式來處理網(wǎng)址和電子郵件信箱,只要是用<>包起來, Markdown 就會(huì)自動(dòng)把它轉(zhuǎn)成鏈接。一般網(wǎng)址的鏈接文字就和鏈接地址一樣,例如:
代碼:
<http://example.com/>   
<address@example.com>
顯示效果:
<http://example.com/> ??
<address@example.com>
2.6 無序列表、有序列表、定義型列表
-
無序列表
使用 *,+,- 表示無序列表。
代碼:
* 無序列表項(xiàng) 一
+ 無序列表項(xiàng) 二
- 無序列表項(xiàng) 三
顯示效果:
- 無序列表項(xiàng) 一
- 無序列表項(xiàng) 二
- 無序列表項(xiàng) 三
- 有序列表
有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn)。
代碼:
1. 有序列表項(xiàng) 一
2. 有序列表項(xiàng) 二
3. 有序列表項(xiàng) 三
顯示效果:
- 有序列表項(xiàng) 一
- 有序列表項(xiàng) 二
- 有序列表項(xiàng) 三
- 定義型列表表
語法說明:
定義型列表由名詞和解釋組成。一行寫上定義,緊跟一行寫上解釋。解釋的寫法:緊跟一個(gè)縮進(jìn)(Tab)
代碼
: 輕量級(jí)文本標(biāo)記語言(左側(cè)有一個(gè)可見的冒號(hào)和四個(gè)不可見的空格)
顯示效果:
Markdown
: 輕量級(jí)文本標(biāo)記語言,可以轉(zhuǎn)換成html,pdf等格式
2.7 插入圖像
語法中圖片Alt的意思是如果圖片因?yàn)槟承┰虿荒茱@示,就用定義的圖片Alt文字來代替圖片。 圖片Title則和鏈接中的Title一樣,表示鼠標(biāo)懸停與圖片上時(shí)出現(xiàn)的文字。 Alt 和 Title 都不是必須的,可以省略,但建議寫上。
Markdown 語法:
<center> <!--開始居中對(duì)齊-->

格式: 
</center> <!--結(jié)束居中對(duì)齊-->
效果如下:

2.8 多級(jí)引用
語法說明:
引用需要在被引用的文本前加上>符號(hào)和空格,允許多層嵌套,也允許你偷懶只在整個(gè)段落的第一行最前面加上 > 。
代碼:
> 請(qǐng)問 Markdwon 怎么用? - 小白
>> 自己看教程! - 憤青
>>> 教程在哪? - 小白
顯示效果:
請(qǐng)問 Markdwon 怎么用? - 小白
自己看教程! - 憤青
教程在哪? - 小白
2.9 轉(zhuǎn)義字符、字體、字號(hào)、顏色
- 轉(zhuǎn)義字符
Markdown中的轉(zhuǎn)義字符為\,轉(zhuǎn)義的有:
\ 反斜杠?` 反引號(hào)?* 星號(hào)?_ 下劃線?{} 大括號(hào)?[] 中括號(hào)?() 小括號(hào)? # 井號(hào)?+ 加號(hào)?- 減號(hào)?. 英文句號(hào)?! 感嘆號(hào)
- 字體、字號(hào)、顏色
代碼:
<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>
顯示效果:
<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 代碼塊
對(duì)于程序員來說這個(gè)功能是必不可少的,插入程序代碼的方式有兩種,一種是利用縮進(jìn)(Tab), 另一種是利用”`”符號(hào)(一般在ESC鍵下方)包裹代碼。
- 行內(nèi)式
代碼:
C語言里的函數(shù) `scanf()` 怎么使用?
顯示效果:
C語言里的函數(shù) scanf() 怎么使用?
- 縮進(jìn)式多行代碼
縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符
一個(gè)代碼區(qū)塊會(huì)一直持續(xù)到?jīng)]有縮進(jìn)的那一行(或是文件結(jié)尾)。
代碼:
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
顯示效果:
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
- 用六個(gè)`包裹多行代碼
代碼:
、、、
include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
、、、
顯示效果:
include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
3.3 流程圖
編輯自有道云筆記,代碼:
```
graph LR
A-->B
```
```
sequenceDiagram
A->>B: How are you?
B->>A: Great!
```
顯示效果:
graph LR
A-->B
sequenceDiagram
A->>B: How are you?
B->>A: Great!
3.4 表格
語法說明:
不管是哪種方式,第一行為表頭,第二行分隔表頭和主體部分,第三行開始每一行為一個(gè)表格行。
列于列之間用管道符|隔開。原生方式的表格每一行的兩邊也要有管道符。
第二行還可以為不同的列指定對(duì)齊方向。默認(rèn)為左對(duì)齊,在-右邊加上:就右對(duì)齊。
- 左對(duì)齊, :-: 中心對(duì)齊,-: 右對(duì)齊
表格代碼:
|學(xué)號(hào)|姓名|序號(hào)|
|-|-|-|
|小明明|男|5|
|小紅|女|79|
|小陸|男|192|
原生方式寫表格:
<center>
| 學(xué)號(hào) | 姓名 | 序號(hào) |
|---|---|---|
| 小明明 | 男 | 5 |
| 小紅 | 女 | 79 |
| 小陸 | 男 | 192 |
</center>
3.5 LaTeX 公式
- 表示行內(nèi)公式
代碼:
質(zhì)能守恒方程可以用一個(gè)很簡(jiǎn)潔的方程式 `$E = m c^2 $`來表達(dá)。
顯示效果:
質(zhì)能守恒方程可以用一個(gè)很簡(jiǎn)潔的方程式 $E = m c^2 $來表達(dá)。
-
表示整行公式
大部分的瀏覽器支持的
$$ 公式 $$
有道云筆記 使用格式,
```math
E = mc^2
```
塊級(jí)公式:
```math
x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a}
```
```math
[\frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} =
1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}
{1+\frac{e^{-8\pi}} {1+\ldots} } } }]
```
顯示效果:
x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a}
[\frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} =
1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}
{1+\frac{e^{-8\pi}} {1+\ldots} } } }]
訪問 MathJax 參考更多使用方法。
3.6 分隔線
你可以在一行中用三個(gè)以上的星號(hào)、減號(hào)、底線來建立一個(gè)分隔線,行內(nèi)不能有其他東西。你也可以在星號(hào)或是減號(hào)中間插入空格。下面每種寫法都可以建立分隔線:
代碼:
* * *
***
*****
- - -
-----------
顯示效果都一樣:
3.7 HTML 原始碼
在代碼區(qū)塊里面, & 、 < 和 > 會(huì)自動(dòng)轉(zhuǎn)成 HTML 實(shí)體,這樣的方式讓你非常容易使用 Markdown 插入范例用的 HTML 原始碼,只需要復(fù)制貼上,剩下的 Markdown 都會(huì)幫你處理,例如:
代碼:
第一個(gè)例子:
<div class="footer">
? 2004 Foo Corporation
</div>
第二個(gè)例子:
<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>
顯示效果:
第一個(gè)例子:
<div class="footer">
? 2004 Foo Corporation
</div>
第二個(gè)例子:
<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>
| 特殊字符 | 描述 | 字符的代碼 |
|---|---|---|
| 空格符 | |
|
| < | 小于號(hào) | < |
| > | 大于號(hào) | > |
| & | 和號(hào) | & |
| ¥ | 人民幣 | ¥ |
| ? | 版權(quán) | © |
| ? | 注冊(cè)商標(biāo) | ® |
| °C | 攝氏度 | °C |
| ± | 正負(fù)號(hào) | ± |
| × | 乘號(hào) | × |
| ÷ | 除號(hào) | ÷ |
| 2 | 平方(上標(biāo)2) | ² |
| 3 | 立方(上標(biāo)3) | ³ |
</center>
版權(quán)歸屬 ?2019 擇勢(shì)量投