Markdown語法大全(超級(jí)版)

說明:現(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í)體, 例如&lt;&amp;。

二、行內(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】 &emsp;或&#8195; //全角
【2】 &ensp;或&#8194; //半角
【3】 &nbsp;或&#160;  //半角之半角
  • 換行

由于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)址的鏈接文字就和鏈接地址一樣,例如:

代碼:

&lt;http://example.com/&gt; &emsp;&emsp; 
&lt;address@example.com&gt;

顯示效果:

<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) 三

顯示效果:

  1. 有序列表項(xiàng) 一
  2. 有序列表項(xiàng) 二
  3. 有序列表項(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ì)齊-->

![GitHub set up](http://zh.mweb.im/asset/img/set-up-git.gif "圖片Title")
格式: ![圖片Alt](圖片地址 "圖片Title")
</center> <!--結(jié)束居中對(duì)齊-->

效果如下:


GitHub set up

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 &lt;stdio.h&gt;
int main(void)
{
    printf(&#34;Hello world\n&#34;);
}

顯示效果:

#include &lt;stdio.h&gt;
int main(void)
{
    printf(&#34;Hello world\n&#34;);
}
  • 用六個(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>

特殊字符 描述 字符的代碼
空格符 &nbsp;
< 小于號(hào) &lt;
> 大于號(hào) &gt;
& 和號(hào) &amp;
人民幣 &yen;
? 版權(quán) &copy;
? 注冊(cè)商標(biāo) &reg;
°C 攝氏度 &deg;C
± 正負(fù)號(hào) &plusmn;
× 乘號(hào) &times;
÷ 除號(hào) &divide;
2 平方(上標(biāo)2) &sup2;
3 立方(上標(biāo)3) &sup3;

</center>

版權(quán)歸屬 ?2019 擇勢(shì)量投


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

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

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • Markdown概述 宗旨 Markdown 的目標(biāo)是實(shí)現(xiàn)「易讀易寫」。Markdown 的特點(diǎn)就是,讓寫作變得更...
    心疼你萌萌噠閱讀 10,041評(píng)論 1 24
  • Markdown 語法手冊(cè) (完整整理版) 原創(chuàng) 2016年09月15日 22:35:35 標(biāo)簽: markdow...
    安卓_背包客閱讀 3,303評(píng)論 0 3
  • (Markdown語法沒有一個(gè)統(tǒng)一的標(biāo)準(zhǔn),不同的工具或平臺(tái)采用的標(biāo)準(zhǔn)不一樣,所以有些語法規(guī)則和功能是有差異的) 0...
    遲道閱讀 57,441評(píng)論 4 69
  • 0. 目錄 0. 目錄1. 斜體和粗體2. 分級(jí)標(biāo)題3. 超鏈接3.1. 行內(nèi)式3.2. 參考式3.3. 自動(dòng)鏈接...
    躍文閱讀 1,446評(píng)論 0 1
  • 堅(jiān)持原創(chuàng)分享第102天 有時(shí)候表面看一個(gè)人會(huì)覺得有這樣那樣不能讓人理解的地方,但當(dāng)你真正了解其內(nèi)心,了解...
    我是一只沒有腳的鳥閱讀 872評(píng)論 0 0

友情鏈接更多精彩內(nèi)容