Markdown 語法手冊

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

代碼:

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

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


2- 分級標題

第一種寫法:

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

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

第二種寫法:

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


3- 超鏈接

Markdown 支持兩種形式的鏈接語法: 行內式和參考式兩種形式,行內式一般使用較多。

3-1- 行內式

語法說明:

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

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

代碼:

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

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

顯示效果:

歡迎訪問 賣姑娘的小火柴

歡迎訪問 賣姑娘的小火柴


3-2- 參考式

參考式超鏈接一般用在學術論文上面,或者另一種情況,如果某一個鏈接在文章中多處使用,那么使用引用 的方式創建鏈接將非常好,它可以讓你對鏈接進行統一的管理。

語法說明:

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

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

代碼:

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

[知乎網站][2] :與世界分享你的知識、經驗和見解

[點擊][]開始分享

[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知乎 以及 賣姑娘的小火柴

知乎網站 :與世界分享你的知識、經驗和見解

點擊 開始分享


3-3- 自動鏈接

語法說明:

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

代碼:


<http://example.com/>

<address@example.com>

顯示效果:

http://example.com/

address@example.com


4- 錨點

網頁中,錨點其實就是頁內超鏈接,也就是鏈接本文檔內部的某些元素,實現當前頁面中的跳轉。比如我這里寫下一個錨點,點擊回到目錄,就能跳轉到目錄。 在目錄中點擊這一節,就能跳過來。還有下一節的注腳。這些根本上都是用錨點來實現的。

注意:
Markdown 似乎不支持錨點,但是可以通過插入HTML實現錨點。

語法描述:

使用 h1 / h2 ( # 個數對應相應級別的 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- 有序列表

有序列表則使用數字接著一個英文句點。

代碼:

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


顯示效果:

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

6- 引用

語法說明:

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

代碼:

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

顯示效果:

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

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


6-1- 引用的多層嵌套

區塊引用可以嵌套(例如:引用內的引用),只要根據層次加上不同數量的 > :

代碼:

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

顯示效果:

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


7- 插入圖像

圖片的創建方式與超鏈接相似,而且和超鏈接一樣也有兩種寫法,行內式和參考式寫法。

7-1- 行內式

語法說明:

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

代碼:

賣姑娘的小火柴 :

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

顯示效果:

賣姑娘的小火柴 :

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

7-2- 參考式

語法說明:

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

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

代碼:

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

顯示效果:

賣姑娘的小火柴 :

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

8- 表格

語法說明:

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

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

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

代碼:

簡單方式寫表格:

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

原生方式寫表格:


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

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

學號 姓名 分數
小明 75
小紅 79
小陸 92

原生方式寫表格:

學號 姓名 分數
小明 75
小紅 79
小陸 92

9- 分隔線

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

代碼:

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

顯示效果 :



10- 代碼

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

語法說明:

插入行內代碼,即插入一個單詞或者一句代碼的情況,使用 `code` 這樣的形式插入。
插入多行代碼,可以使用縮進或者 ``` code ``` ,具體看示例。
注意: 縮進式插入前方必須有空行

10-1- 行內式

代碼:

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

顯示效果:

PHP 是世界上最好的語言

10-2- 縮進式多行代碼

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

一個代碼區塊會一直持續到沒有縮進的那一行(或是文件結尾)。

代碼:

    #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");
}

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,622評論 6 544
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,716評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,746評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,991評論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,706評論 6 413
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 56,036評論 1 329
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,029評論 3 450
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,203評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,725評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,451評論 3 361
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,677評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,161評論 5 365
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,857評論 3 351
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,266評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,606評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,407評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,643評論 2 380

推薦閱讀更多精彩內容