前言
Markdown 是一種輕量級(jí)的 標(biāo)記語(yǔ)言奢驯,語(yǔ)法簡(jiǎn)潔明了黍檩、學(xué)習(xí)容易叉袍,還具有其他很多優(yōu)點(diǎn),目前被越來(lái)越多的人用來(lái)寫(xiě)作使用建炫。
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)行展示,可在開(kāi)始的** ``` **后面加上代碼語(yǔ)種名稱朝捆。
`` ` javascript
var str = "hello world!";
alert(str);
`` `
為了顯示般渡,上面給出的```加了一個(gè)空格。
var str = "hello world!";
alert(str);
上面就是效果
圖片
圖片展示
方式1:
![文本內(nèi)容](https://help.github.com/assets/images/site/favicon.ico "logo")
方式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í)候猴仑,可以不用寫(xiě)鏈接后面的Id。
[SeayXu][]
[SeayXu]: https://github.com/SeayXu "Seay"
[SeayXu][]
[SeayXu]: https://github.com/SeayXu "Seay"
圖片鏈接
給圖片加上超鏈接
方式1:
[![Github](https://help.github.com/assets/images/site/favicon.ico "Seay")](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羡藐。
我是圖片:
本文來(lái)自:markdown-general-common-syntax
本文就介紹到這里,如有不足之處悯许,可隨時(shí)與我聯(lián)系仆嗦。