
前言
Markdown 是一種輕量級(jí)的 標(biāo)記語(yǔ)言,語(yǔ)法簡(jiǎn)潔明了、學(xué)習(xí)容易,還具有其他很多優(yōu)點(diǎn),目前被越來(lái)越多的人用來(lái)寫作使用。
Markdown具有一系列衍生版本,用于擴(kuò)展Markdown的功能(如表格、腳注、內(nèi)嵌HTML等等),這些功能原初的Markdown尚不具備,它們能讓Markdown轉(zhuǎn)換成更多的格式,例如LaTeX,Docbook。Markdown增強(qiáng)版中比較有名的有Markdown Extra、MultiMarkdown、 Maruku等。這些衍生版本要么基于工具,如Pandoc;要么基于網(wǎng)站,如GitHub和Wikipedia,在語(yǔ)法上基本兼容,但在一些語(yǔ)法和渲染效果上有改動(dòng)。
由于一些擴(kuò)展只在特定的環(huán)境中才能實(shí)現(xiàn),所以這里介紹的是通用的常用語(yǔ)法說(shuō)明。
語(yǔ)法
下面就是常用的Markdown語(yǔ)法內(nèi)容,以標(biāo)準(zhǔn)Markdown語(yǔ)法為依據(jù),可能這里有一些差異,請(qǐng)以語(yǔ)法為準(zhǔn)。
標(biāo)題
標(biāo)題分為6級(jí),對(duì)應(yīng)HTML標(biāo)簽的h1~h6。#越多,字體越小。
# H1標(biāo)題
## H2標(biāo)題
### H3標(biāo)題
#### H4標(biāo)題
##### H5標(biāo)題
###### H6標(biāo)題
H1標(biāo)題
H2標(biāo)題
H3標(biāo)題
H4標(biāo)題
H5標(biāo)題
H6標(biāo)題
分隔符
分隔符就是一條橫線。
---
文本樣式
斜體
* 斜體文本 *
_ 斜體文本 _
斜體文本 斜體文本
粗體
加粗就是是文字為粗體顯示,可以使用下面兩中方式表示:
**粗體文本**
__粗體文本__
粗體文本
粗體文本
斜粗體
***斜粗體文本*** *__斜粗體文本__*
_**斜粗體文本**_ ___斜粗體文本___
斜粗體文本 斜粗體文本
斜粗體文本 斜粗體文本
刪除線
文字有一條刪除線的效果
~~ 刪除效果 ~~
刪除效果
高亮
文字用醒目的高亮顯示
這是` 高亮文本 `效果。
這是高亮文本效果。
代碼塊
代碼塊就是將源碼直接進(jìn)行展示,可在開始的** ``` **后面加上代碼語(yǔ)種名稱。
`` ` javascript
var str = "hello world!";
alert(str);
`` `
為了顯示,上面給出的```加了一個(gè)空格。
var str = "hello world!";
alert(str);
上面就是效果
圖片
圖片展示
方式1:

方式2:
![文本內(nèi)容][img]
[img]:https://help.github.com/assets/images/site/favicon.ico "logo"
方式1:
方式2:
![文本內(nèi)容][img]
[img]:https://help.github.com/assets/images/site/favicon.ico "logo"
<h6 id="url-more">說(shuō)明:</h6>
URL后面的內(nèi)容是鼠標(biāo)hover提示文本,可以省略,省略時(shí)就沒(méi)有鼠標(biāo)hover提示文本效果。
推薦使用方式2,當(dāng)一個(gè)鏈接在文中多次出現(xiàn)的時(shí)候,就會(huì)體現(xiàn)出其優(yōu)點(diǎn)了。
另外,后面的提示文本除了使用 "提示文本" 外,還可以是 '提示文本' 和 (提示文本) 。
[id]:URL "鼠標(biāo)hover提示文本"
[id]:URL '鼠標(biāo)hover提示文本'
[id]:URL (鼠標(biāo)hover提示文本)
鏈接
鏈接根據(jù)鏈接目標(biāo)可分為站內(nèi)站外鏈接,按照類型可分為文本鏈接和圖片鏈接。
綜上所述,可分為以下三種:
文本鏈接
給文本信息添加超鏈接
1.<https://github.com/SeayXu>
2.[文本鏈接](https://github.com/SeayXu "SeayXu")
3.[文本鏈接][id]
[id]:https://github.com/SeayXu "SeayXu"
1.https://github.com/SeayXu
2.文本鏈接
3.[文本鏈接][id]
[id]:https://github.com/SeayXu "SeayXu"
鏈接URL相關(guān)說(shuō)明和圖片一樣,請(qǐng)查看
特例:
當(dāng)鏈接的文本內(nèi)容和鏈接Id相同的時(shí)候,可以不用寫鏈接后面的Id。
[SeayXu][]
[SeayXu]: https://github.com/SeayXu "Seay"
[SeayXu][]
[SeayXu]: https://github.com/SeayXu "Seay"
圖片鏈接
給圖片加上超鏈接
方式1:
[](https://github.com/SeayXu "SeayXu")
方式2:
[![Github][img-url]][link-url]
[link-url]:https://github.com/SeayXu "SeayXu"
[img-url]:https://help.github.com/assets/images/site/favicon.ico "Seay"
方式2:
![Github][github-img]
提示:由于各個(gè)Markdown解析不同,所以顯示的提示文本有可能也不太一樣。
錨點(diǎn)
錨點(diǎn)其實(shí)與文本鏈接和圖片鏈接用法是一樣的,只不過(guò)是在本頁(yè)面內(nèi),需要稍微改動(dòng)下。
設(shè)置錨點(diǎn)鏈接目標(biāo):
<h6 id="url-more">說(shuō)明:</h6>
添加錨點(diǎn):
[錨點(diǎn)](#url-more "anchor alt text")
[錨點(diǎn)][anchor]
[anchor]:#url-more "anchor alt text"
錨點(diǎn)
[錨點(diǎn)][anchor]
[anchor]:#url-more "anchor alt text"
說(shuō)明:相對(duì)于文本鏈接和圖片鏈接,主要是添加了錨點(diǎn)鏈接目標(biāo)這一操作,使用語(yǔ)法跟文本鏈接和圖片鏈接一樣。
列表
列表分為有序和無(wú)序兩種。
無(wú)序列表
無(wú)序列表有三種表示方法:* 、 + 和 -。
下級(jí)在上級(jí)基礎(chǔ)上前面多加兩個(gè)空格,符號(hào)與內(nèi)容直接有一個(gè)空格。
無(wú)序列表1:
* 一級(jí)條目1
* 一級(jí)條目2
* 二級(jí)條目1
* 二級(jí)條目2
* 三級(jí)條目1
* 三級(jí)條目2
* 三級(jí)條目3
* 二級(jí)條目3
* 一級(jí)條目3
- 一級(jí)條目1
- 一級(jí)條目2
- 二級(jí)條目1
- 二級(jí)條目2
- 三級(jí)條目1
- 三級(jí)條目2
- 三級(jí)條目3
- 二級(jí)條目3
- 一級(jí)條目3
在這里只演示一種,另外兩種就是把 * 分別換成 + 和 - 。
有序列表
有序列表與無(wú)序列表類似,只不是是將前面的符號(hào)換成數(shù)字而已。
1. 一級(jí)條目1
2. 一級(jí)條目2
1. 二級(jí)條目1
* 二級(jí)條目2
* 三級(jí)條目1
+ 三級(jí)條目2
- 三級(jí)條目3
- 二級(jí)條目3
2. 一級(jí)條目3
- 一級(jí)條目1
- 一級(jí)條目2
- 二級(jí)條目1
- 二級(jí)條目2
- 三級(jí)條目1
- 三級(jí)條目2
- 三級(jí)條目3
- 二級(jí)條目3
- 一級(jí)條目3
說(shuō)明:
- 有序列表有自動(dòng)糾錯(cuò)功能,當(dāng)序號(hào)輸入錯(cuò)誤時(shí),會(huì)自動(dòng)更正顯示序號(hào)。
- 有序列表可結(jié)合無(wú)序列表,只在第一個(gè)條目輸入序號(hào)后,同級(jí)條目會(huì)自動(dòng)編號(hào)。
引用
引用內(nèi)容可以嵌套引用和使用其他語(yǔ)法,在引用內(nèi)容后面空一行就表示引用結(jié)束。
>這是一段包含**加粗**的 _斜體_ 和 _**斜粗體**_ 并帶有`高亮`顯示的一段文本來(lái)自[我的Github](https://github.com/SeayXu "SeayXu")。
我是圖片:
![github logo][github-img]
[github-url]:https://github.com/SeayXu "SeayXu"
這是一段包含加粗的 斜體 和 斜粗體 并帶有
高亮顯示的一段文本來(lái)自我的Github。
我是圖片:
github logo
本文來(lái)自:markdown-general-common-syntax
本文就介紹到這里,如有不足之處,可隨時(shí)與我聯(lián)系。