Markdown 語法手冊

<h2 id = "index_1">1- 斜體和粗體</h2>

代碼:

    *斜體*或_斜體_
    **粗體**
    ***加粗斜體***
    ~~刪除線~~

顯示效果:
這是一段斜體
這是一段粗體
這是一段加粗斜體
這是一段刪除線


2- 分級標題

第一種寫法:

這是一個一級標題
============================

這是一個二級標題
--------------------------------------------------

第二種寫法:

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題


3- 超鏈接

Markdown 支持兩種形式的鏈接語法: 行內(nèi)式和參考式兩種形式辞友,行內(nèi)式一般使用較多。

3-1- 行內(nèi)式

語法說明:

[ ] 里寫鏈接文字,( )里寫鏈接地址, ( )中的""中可以為鏈接指定 title 屬性骂租,title 屬性可加可不加顾稀。

title 屬性的效果是鼠標懸停在鏈接上會出現(xiàn)指定的 title文字歧胁。[ 鏈接文字 ]( 鏈接地址 "鏈接標題" )這樣的形式舟肉。鏈接地址與鏈接標題前有一個空格包竹。

代碼:

歡迎訪問 [賣姑娘的小火柴](https://gfigure.github.io/)

歡迎訪問 [賣姑娘的小火柴](https://gfigure.github.io/ "賣姑娘的小火柴")

顯示效果:

歡迎訪問 賣姑娘的小火柴

歡迎訪問 賣姑娘的小火柴


3-2- 參考式

參考式超鏈接一般用在學術論文上面燕酷,或者另一種情況籍凝,如果某一個鏈接在文章中多處使用,那么使用引用 的方式創(chuàng)建鏈接將非常好苗缩,它可以讓你對鏈接進行統(tǒng)一的管理饵蒂。

語法說明:

參考式鏈接分為兩部分,文中的寫法 [鏈接文字][鏈接標記]酱讶,在文本的任意位置添加[鏈接標記]:鏈接地址 “鏈接標題”退盯,鏈接地址與鏈接標題前有一個空格。

如果鏈接文字本身可以做為鏈接標記浴麻,你也可以寫成[鏈接文字][]
[鏈接文字]:鏈接地址的形式得问,見代碼的最后一行。

代碼:

友情鏈接:[Google][1]软免、[知乎][2] 以及 [賣姑娘的小火柴][3]

[知乎網(wǎng)站][2] :與世界分享你的知識、經(jīng)驗和見解

[點擊][]開始分享

[1]:http://www.google.com "Google"
[2]:https://www.zhihu.com/ "知乎"
[3]:https://gfigure.github.io/ "梵居鬧市"
[點擊]:https://www.zhihu.com/people/geng-dong-fei/activities

顯示效果:

友情鏈接:Google焚挠、知乎 以及 賣姑娘的小火柴

知乎網(wǎng)站 :與世界分享你的知識膏萧、經(jīng)驗和見解

點擊 開始分享


3-3- 自動鏈接

語法說明:

Markdown 支持以比較簡短的自動鏈接形式來處理網(wǎng)址和電子郵件信箱,只要是用<>包起來蝌衔, Markdown 就會自動把它轉成鏈接榛泛。一般網(wǎng)址的鏈接文字就和鏈接地址一樣,例如:

代碼:


<http://example.com/>

<address@example.com>

顯示效果:

http://example.com/

address@example.com


4- 錨點

網(wǎng)頁中噩斟,錨點其實就是頁內(nèi)超鏈接曹锨,也就是鏈接本文檔內(nèi)部的某些元素,實現(xiàn)當前頁面中的跳轉剃允。比如我這里寫下一個錨點沛简,點擊回到目錄,就能跳轉到目錄斥废。 在目錄中點擊這一節(jié)椒楣,就能跳過來。還有下一節(jié)的注腳牡肉。這些根本上都是用錨點來實現(xiàn)的捧灰。

注意:
Markdown 似乎不支持錨點,但是可以通過插入HTML實現(xiàn)錨點统锤。

語法描述:

使用 h1 / h2 ( # 個數(shù)對應相應級別的 HTML 樣式標題)毛俏,且使用 id 屬性命名錨。<h1 id="錨點名稱"> 錨點 </h1> 饲窿,鏈接至標題 [ 標題 ](# 錨點名稱 )
使用 a 標簽: <a name="錨點名稱"> 標題 </a>煌寇,鏈接至標題<a href="錨點名稱"> 錨點 </a>

代碼:

<h1 id = "目錄">0. 目錄</h1>

跳轉到[目錄](#目錄)


## <a name="index_1"> 1. 斜體和粗體 </a>

<a href="#index_1"> 跳轉到 1. 斜體和粗體 </a>


顯示效果:

跳轉到 1 - 斜體和粗體

注意 a 標簽它具有自身的樣式,在這里就不示范了免绿。


5- 列表

5-1- 無序列表

使用 *唧席,+,- 表示無序列表。

代碼:

- 無序列表項 一
- 無序列表項 二
- 無序列表項 三

顯示效果:

  • 無序列表項 一
  • 無序列表項 二
  • 無序列表項 三

5-2- 有序列表

有序列表則使用數(shù)字接著一個英文句點淌哟。

代碼:

1. 有序列表項 一
2. 有序列表項 二
3. 有序列表項 三


顯示效果:

  1. 有序列表項 一
  2. 有序列表項 二
  3. 有序列表項 三

6- 引用

語法說明:

引用需要在被引用的文本前加上 > 符號迹卢。

代碼:

> 這是一個有兩段文字的引用,
> 無意義的占行文字1.
> 無意義的占行文字2.
> 
> 無意義的占行文字3.
> 無意義的占行文字4.

顯示效果:

這是一個有兩段文字的引用,
無意義的占行文字1.
無意義的占行文字2.

無意義的占行文字3.
無意義的占行文字4.


6-1- 引用的多層嵌套

區(qū)塊引用可以嵌套(例如:引用內(nèi)的引用),只要根據(jù)層次加上不同數(shù)量的 > :

代碼:

>>> 請問 Markdwon 怎么用徒仓? - 小白
>> 自己看教程腐碱! - 憤青
> 教程在哪? - 小白

顯示效果:

請問 Markdwon 怎么用掉弛? - 小白
自己看教程症见! - 憤青
教程在哪? - 小白


7- 插入圖像

圖片的創(chuàng)建方式與超鏈接相似殃饿,而且和超鏈接一樣也有兩種寫法谋作,行內(nèi)式和參考式寫法。

7-1- 行內(nèi)式

語法說明:

![圖片Alt](圖片地址 “圖片Title”)
語法中圖片Alt的意思是如果圖片因為某些原因不能顯示乎芳,就用定義的圖片Alt文字來代替圖片遵蚜。 圖片Title則和鏈接中的Title一樣,表示鼠標懸停與圖片上時出現(xiàn)的文字奈惑。 Alt 和 Title 都不是必須的吭净,可以省略,但建議寫上肴甸。

代碼:

賣姑娘的小火柴 :

![賣姑娘的小火柴](http://oqiflua2i.bkt.clouddn.com/avatar.png "賣姑娘的小火柴")

顯示效果:

賣姑娘的小火柴 :

賣姑娘的小火柴
賣姑娘的小火柴

7-2- 參考式

語法說明:

在文檔要插入圖片的地方寫 ! [ 圖片Alt ] [ 標記]

在文檔的最后寫上 [ 標記 ] : 圖片地址 “Title”

代碼:

賣姑娘的小火柴 :
![賣姑娘的小火柴][flower]
[flower]:http://oqiflua2i.bkt.clouddn.com/avatar.png   "賣姑娘的小火柴"

顯示效果:

賣姑娘的小火柴 :

賣姑娘的小火柴
賣姑娘的小火柴

8- 表格

語法說明:

不管是哪種方式寂殉,第一行為表頭,第二行分隔表頭和主體部分原在,第三行開始每一行為一個表格行友扰。

列于列之間用管道符|隔開。原生方式的表格每一行的兩邊也要有管道符晤斩。

第二行還可以為不同的列指定對齊方向焕檬。默認為左對齊,在-右邊加上:就右對齊澳泵。

代碼:

簡單方式寫表格:

學號|姓名|分數(shù)
-|-|-
小明|男|75
小紅|女|79
小陸|男|92

原生方式寫表格:


|學號|姓名|分數(shù)|
|-|-|-|
|小明|男|75|
|小紅|女|79|
|小陸|男|92|

顯示效果:
簡單方式寫表格:

學號 姓名 分數(shù)
小明 75
小紅 79
小陸 92

原生方式寫表格:

學號 姓名 分數(shù)
小明 75
小紅 79
小陸 92

9- 分隔線

你可以在一行中用三個以上的星號实愚、減號、底線來建立一個分隔線兔辅,行內(nèi)不能有其他東西腊敲。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:

代碼:

* * *
***
*****
- - -
---------------------------------------

顯示效果 :



10- 代碼

對于程序員來說這個功能是必不可少的维苔,插入程序代碼的方式有兩種碰辅,一種是利用縮進( Tab ), 另一種是利用 " ` " 符號(一般在ESC鍵下方)包裹代碼介时。

語法說明:

插入行內(nèi)代碼没宾,即插入一個單詞或者一句代碼的情況凌彬,使用 `code` 這樣的形式插入。
插入多行代碼循衰,可以使用縮進或者 ``` code ``` 铲敛,具體看示例。
注意: 縮進式插入前方必須有空行

10-1- 行內(nèi)式

代碼:

  `PHP`  是世界上最好的語言

顯示效果:

PHP 是世界上最好的語言

10-2- 縮進式多行代碼

縮進 4 個空格或是 1 個制表符

一個代碼區(qū)塊會一直持續(xù)到?jīng)]有縮進的那一行(或是文件結尾)会钝。

代碼:

    #include <stdio.h>
    int main(void)
    {
        printf("Hello world\n");
    }

顯示效果:

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

10-3- 用六個 ` 包裹多行代碼

代碼:

 ` ` `
#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}
 ` ` `

顯示效果:

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

最后編輯于
?著作權歸作者所有,轉載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末伐蒋,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子迁酸,更是在濱河造成了極大的恐慌先鱼,老刑警劉巖,帶你破解...
    沈念sama閱讀 218,682評論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件奸鬓,死亡現(xiàn)場離奇詭異焙畔,居然都是意外死亡,警方通過查閱死者的電腦和手機全蝶,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,277評論 3 395
  • 文/潘曉璐 我一進店門闹蒜,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人抑淫,你說我怎么就攤上這事±焉粒” “怎么了始苇?”我有些...
    開封第一講書人閱讀 165,083評論 0 355
  • 文/不壞的土叔 我叫張陵,是天一觀的道長筐喳。 經(jīng)常有香客問我催式,道長,這世上最難降的妖魔是什么避归? 我笑而不...
    開封第一講書人閱讀 58,763評論 1 295
  • 正文 為了忘掉前任荣月,我火速辦了婚禮,結果婚禮上梳毙,老公的妹妹穿的比我還像新娘哺窄。我一直安慰自己,他們只是感情好账锹,可當我...
    茶點故事閱讀 67,785評論 6 392
  • 文/花漫 我一把揭開白布萌业。 她就那樣靜靜地躺著,像睡著了一般奸柬。 火紅的嫁衣襯著肌膚如雪生年。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,624評論 1 305
  • 那天廓奕,我揣著相機與錄音抱婉,去河邊找鬼档叔。 笑死,一個胖子當著我的面吹牛蒸绩,可吹牛的內(nèi)容都是我干的衙四。 我是一名探鬼主播,決...
    沈念sama閱讀 40,358評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼侵贵,長吁一口氣:“原來是場噩夢啊……” “哼届搁!你這毒婦竟也來了?” 一聲冷哼從身側響起窍育,我...
    開封第一講書人閱讀 39,261評論 0 276
  • 序言:老撾萬榮一對情侶失蹤卡睦,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后漱抓,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體表锻,經(jīng)...
    沈念sama閱讀 45,722評論 1 315
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,900評論 3 336
  • 正文 我和宋清朗相戀三年乞娄,在試婚紗的時候發(fā)現(xiàn)自己被綠了瞬逊。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 40,030評論 1 350
  • 序言:一個原本活蹦亂跳的男人離奇死亡仪或,死狀恐怖确镊,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情范删,我是刑警寧澤蕾域,帶...
    沈念sama閱讀 35,737評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站到旦,受9級特大地震影響旨巷,放射性物質發(fā)生泄漏。R本人自食惡果不足惜添忘,卻給世界環(huán)境...
    茶點故事閱讀 41,360評論 3 330
  • 文/蒙蒙 一采呐、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧搁骑,春花似錦斧吐、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,941評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至娄周,卻和暖如春涕侈,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背煤辨。 一陣腳步聲響...
    開封第一講書人閱讀 33,057評論 1 270
  • 我被黑心中介騙來泰國打工裳涛, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留木张,地道東北人。 一個月前我還...
    沈念sama閱讀 48,237評論 3 371
  • 正文 我出身青樓端三,卻偏偏與公主長得像舷礼,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子郊闯,可洞房花燭夜當晚...
    茶點故事閱讀 44,976評論 2 355

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