Markdown通用的常用語(yǔ)法說(shuō)明

markdown-logo

前言

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:

文本內(nèi)容
文本內(nèi)容

方式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"

方式1:


方式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
  1. 一級(jí)條目1
  2. 一級(jí)條目2
  3. 二級(jí)條目1
  • 二級(jí)條目2
    • 三級(jí)條目1
    • 三級(jí)條目2
    • 三級(jí)條目3
  • 二級(jí)條目3
  1. 一級(jí)條目3

說(shuō)明:

  1. 有序列表有自動(dòng)糾錯(cuò)功能埃碱,當(dāng)序號(hào)輸入錯(cuò)誤時(shí),會(huì)自動(dòng)更正顯示序號(hào)酥泞。
  2. 有序列表可結(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
github logo

本文來(lái)自:markdown-general-common-syntax
本文就介紹到這里,如有不足之處悯许,可隨時(shí)與我聯(lián)系仆嗦。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市先壕,隨后出現(xiàn)的幾起案子瘩扼,更是在濱河造成了極大的恐慌,老刑警劉巖启上,帶你破解...
    沈念sama閱讀 211,639評(píng)論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件邢隧,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡冈在,警方通過(guò)查閱死者的電腦和手機(jī)倒慧,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,277評(píng)論 3 385
  • 文/潘曉璐 我一進(jìn)店門(mén),熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)包券,“玉大人纫谅,你說(shuō)我怎么就攤上這事〗蹋” “怎么了付秕?”我有些...
    開(kāi)封第一講書(shū)人閱讀 157,221評(píng)論 0 348
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)侍郭。 經(jīng)常有香客問(wèn)我询吴,道長(zhǎng)掠河,這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 56,474評(píng)論 1 283
  • 正文 為了忘掉前任猛计,我火速辦了婚禮唠摹,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘奉瘤。我一直安慰自己勾拉,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,570評(píng)論 6 386
  • 文/花漫 我一把揭開(kāi)白布盗温。 她就那樣靜靜地躺著藕赞,像睡著了一般。 火紅的嫁衣襯著肌膚如雪卖局。 梳的紋絲不亂的頭發(fā)上斧蜕,一...
    開(kāi)封第一講書(shū)人閱讀 49,816評(píng)論 1 290
  • 那天,我揣著相機(jī)與錄音吼驶,去河邊找鬼惩激。 笑死店煞,一個(gè)胖子當(dāng)著我的面吹牛蟹演,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播顷蟀,決...
    沈念sama閱讀 38,957評(píng)論 3 408
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼酒请,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了鸣个?” 一聲冷哼從身側(cè)響起羞反,我...
    開(kāi)封第一講書(shū)人閱讀 37,718評(píng)論 0 266
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎囤萤,沒(méi)想到半個(gè)月后昼窗,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 44,176評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡涛舍,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,511評(píng)論 2 327
  • 正文 我和宋清朗相戀三年澄惊,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片富雅。...
    茶點(diǎn)故事閱讀 38,646評(píng)論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡掸驱,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出没佑,到底是詐尸還是另有隱情毕贼,我是刑警寧澤,帶...
    沈念sama閱讀 34,322評(píng)論 4 330
  • 正文 年R本政府宣布蛤奢,位于F島的核電站鬼癣,受9級(jí)特大地震影響陶贼,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜待秃,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,934評(píng)論 3 313
  • 文/蒙蒙 一骇窍、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧锥余,春花似錦腹纳、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,755評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至雄驹,卻和暖如春佃牛,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背医舆。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,987評(píng)論 1 266
  • 我被黑心中介騙來(lái)泰國(guó)打工俘侠, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人蔬将。 一個(gè)月前我還...
    沈念sama閱讀 46,358評(píng)論 2 360
  • 正文 我出身青樓爷速,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親霞怀。 傳聞我的和親對(duì)象是個(gè)殘疾皇子惫东,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,514評(píng)論 2 348

推薦閱讀更多精彩內(nèi)容

  • 標(biāo)題 標(biāo)題分為6級(jí),對(duì)應(yīng)HTML標(biāo)簽的h1~h6毙石。#越多廉沮,字體越小。#H1標(biāo)題## H2標(biāo)題### H3標(biāo)題###...
    瘋范兒閱讀 420評(píng)論 0 0
  • Markdown是一種輕量級(jí)的[標(biāo)記語(yǔ)言]徐矩,它的優(yōu)點(diǎn)很多滞时,目前也被越來(lái)越多的寫(xiě)作愛(ài)好者,撰稿者廣泛使用滤灯∑夯看到這里請(qǐng)...
    李阿昀閱讀 18,895評(píng)論 1 18
  • 1. 斜體和粗體 代碼: 顯示效果: 這是一段斜體 這是一段粗體 這是一段加粗斜體 這是一段刪除線 2. 分級(jí)標(biāo)題...
    泊牧閱讀 2,331評(píng)論 0 2
  • 人生 總在經(jīng)受歲月的磨折之后 方至懂得了珍惜身邊的人 比你快樂(lè) 人生 總在經(jīng)受風(fēng)雨的洗禮 方至懂得你所希望的我 是...
    小草_d5ad閱讀 466評(píng)論 21 50
  • 欣賞好的刽漂,但不指望未來(lái)都是好的。
    乞力馬扎羅的咸魚(yú)閱讀 391評(píng)論 0 1