Markdown 新手指南

簡介

Markdown 是一種輕量級標(biāo)記語言赘方,它用簡潔的語法代替排版,使我們專心于碼字刀荒。它的目標(biāo)是實現(xiàn)易讀易寫代嗤,成為一種適用于網(wǎng)絡(luò)的書寫語言。同時缠借,Markdown支持嵌入html標(biāo)簽干毅。

<u>注意:Markdown使用#+泼返、*等符號來標(biāo)記硝逢, 符號后面必須跟上 至少1個 空格才有效!</u>

Markdown的常用語法

標(biāo)題

Markdown 標(biāo)題支持兩種形式:

1绅喉、用#標(biāo)記

標(biāo)題開頭 加上1~6個#渠鸽,依次代表一級標(biāo)題、二級標(biāo)題....六級標(biāo)題

# 一級標(biāo)題
## 二級標(biāo)題
### 三級標(biāo)題
##### 四級標(biāo)題
###### 五級標(biāo)題
###### 六級標(biāo)題

2柴罐、用=-標(biāo)記

標(biāo)題底下 加上任意個=代表一級標(biāo)題徽缚,-代表二級標(biāo)題

一級標(biāo)題
======

二級標(biāo)題
----------

效果如下:

一級標(biāo)題

二級標(biāo)題

三級標(biāo)題

四級標(biāo)題
五級標(biāo)題
六級標(biāo)題

列表

Markdown 支持有序列表和無序列表。

無序列表使用-丽蝎、+*作為列表標(biāo)記:

- Red
- Green
- Blue

* Red
* Green
* Blue

+ Red
+ Green
+ Blue

效果如下:

  • Red
  • Green
  • Blue

有序列表則使用數(shù)字加英文句點.來表示:

1\. Red
2\. Green
3\. Blue

效果如下:

  1. Red
  2. Green
  3. Blue

引用

引用以>來表示猎拨,引用中支持多級引用膀藐、標(biāo)題红省、列表、代碼塊虾啦、分割線等常規(guī)語法。

常見的引用寫法:

> 這是一段引用    //在`>`后面有 1 個空格
> 
>     這是引用的代碼塊形式    //在`>`后面有 5 個空格
>     
> 代碼例子:
>   
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

> 一級引用
> > 二級引用
> > > 三級引用

> #### 這是一個四級標(biāo)題
> 
> 1. 這是第一行列表項
> 2. 這是第二行列表項

效果如下:

這是一段引用

這是引用的代碼塊形式    //在`>`后面有 5 個空格

代碼例子:

protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}

一級引用

二級引用

三級引用

這是一個四級標(biāo)題

  1. 這是第一行列表項
  2. 這是第二行列表項

以下是分割線


強調(diào)

兩個*-代表加粗痕寓,一個*-代表斜體,~~代表刪除呻率。

**加粗文本** 或者 __加粗文本__

*斜體文本*  或者_斜體文本_

~~刪除文本~~

效果如下:

加粗文本 或者 加粗文本

斜體文本 或者 斜體文本

刪除文本


圖片與鏈接

圖片與鏈接的語法很像,區(qū)別在一個 ! 號礼仗。二者格式:

圖片:![]()    ![圖片文本(可忽略)](圖片地址)

鏈接:[]()     [鏈接文本](鏈接地址)

鏈接又分為行內(nèi)式吐咳、參考式自動鏈接

這是行內(nèi)式鏈接:[ConnorLin's Blog](http://connorlin.github.io)。

這是參考式鏈接:[ConnorLin's Blog][url]韭脊,其中url為鏈接標(biāo)記单旁,可置于文中任意位置。

[url]: http://connorlin.github.io/ "ConnorLin's Blog"

鏈接標(biāo)記格式為:[鏈接標(biāo)記文本]:  鏈接地址  鏈接title(可忽略)

這是自動鏈接:直接使用`<>`括起來<http://connorlin.github.io>

這是圖片:![][avatar]

[avatar]: https://connorlin.github.io/images/avatar.jpg

效果如下:

這是行內(nèi)式鏈接:ConnorLin's Blog蔫饰。

這是參考式鏈接:ConnorLin's Blog融柬,其中url為鏈接標(biāo)記,可置于文中任意位置粒氧。

這是自動鏈接:直接使用<>括起來http://connorlin.github.io

這是圖片:

image

代碼

代碼分為行內(nèi)代碼代碼塊外盯。

  • 行內(nèi)代碼使用 代碼 標(biāo)識,可嵌入文字中

  • 代碼塊使用4個空格或```標(biāo)識

    這里是代碼
    
  • 代碼語法高亮在 ```后面加上空格和語言名稱即可

    //注意語言前面有空格
    這里是代碼
    

例如:

這是行內(nèi)代碼`onCreate(Bundle savedInstanceState)`的例子孩擂。

這是代碼塊和語法高亮:

``` java
// 注意java前面有空格
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}

效果如下:

這是行內(nèi)代碼`onCreate(Bundle savedInstanceState)`的例子箱熬。

這是代碼塊和語法高亮:

// 注意java前面有空格
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}


## **表格**

表格對齊格式

*   居左:`:----`
*   居中:`:----:`或`-----`
*   居右:`----:`

例子:

標(biāo)題 標(biāo)題 標(biāo)題
居左測試文本 居中測試文本 居右測試文本
居左測試文本1 居中測試文本2 居右測試文本3
居左測試文本11 居中測試文本22 居右測試文本33
居左測試文本111 居中測試文本222 居右測試文本333

效果如下:

| 標(biāo)題 | 標(biāo)題 | 標(biāo)題 |
| --- | --- | --- |
| 居左測試文本 | 居中測試文本 | 居右測試文本 |
| 居左測試文本1 | 居中測試文本2 | 居右測試文本3 |
| 居左測試文本11 | 居中測試文本22 | 居右測試文本33 |
| 居左測試文本111 | 居中測試文本222 | 居右測試文本333 |

* * *

## **分隔線**

在一行中用三個以上的`*`、`-`米苹、`_`來建立一個分隔線砰琢,行內(nèi)不能有其他東西。也可以在符號間插入空格训唱。






效果均為一條分割線:

* * *

* * *

## **換行**

在行尾添加兩個空格加回車表示換行:

這是一行后面加兩個空格 換行


效果如下:

這是一行后面加兩個空格
換行

* * *

## **腳注(注解)**

使用`[^]`來定義腳注:

這是一個腳注的例子[1]


效果如下:

這是一個腳注的例子<sup>[[1]](#fn1)</sup>

* * *

# **常用彌補Markdown的Html標(biāo)簽**

## **字體**

<font face="微軟雅黑" color="red" size="6">字體及字體顏色和大小</font>
<font color="#0000ff">字體顏色</font>


效果如下:

<font face="微軟雅黑" color="red" size="6">字體及字體顏色和大小</font>
<font color="#0000ff">字體顏色</font>

* * *

## **換行**

使用html標(biāo)簽<br/>
換行


效果如下:

使用html標(biāo)簽`<br/>`
換行

* * *

## **文本對齊方式**

<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>


效果如下:

<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>

* * *

## **下劃線**

<u>下劃線文本</u>

標(biāo)題

這是最為常用的格式况增,在平時常用的的文本編輯器中大多是這樣實現(xiàn)的:輸入文本你辣、選中文本尘执、設(shè)置標(biāo)題格式。

而在 Markdown 中表悬,你只需要在文本前面加上 # 即可丧靡,同理、你還可以增加二級標(biāo)題饭庞、三級標(biāo)題熬荆、四級標(biāo)題、五級標(biāo)題和六級標(biāo)題累盗,總共六級突琳,只需要增加 # 即可,標(biāo)題字號相應(yīng)降低蠢琳。例如:

# 一級標(biāo)題
## 二級標(biāo)題
### 三級標(biāo)題
#### 四級標(biāo)題
##### 五級標(biāo)題
###### 六級標(biāo)題 

注:# 和「一級標(biāo)題」之間建議保留一個字符的空格,這是最標(biāo)準(zhǔn)的 Markdown 寫法孕索。

你可以你的編輯器中嘗試輸入這六級標(biāo)題躏碳,可以參考下方的截圖:

image

列表

列表格式也很常用,在 Markdown 中肄渗,你只需要在文字前面加上 - 就可以了咬最,例如:

- 文本1
- 文本2
- 文本3

如果你希望有序列表,
也可以在文字前面加上 1. 2. 3. 就可以了惑申,例如:

1\. 文本1
2\. 文本2
3\. 文本3

注:-翅雏、1.和文本之間要保留一個字符的空格。

列表案例截圖如下:

image

<h2 id="picture"> 鏈接和圖片</h2>

在 Markdown 中绩脆,插入鏈接不需要其他按鈕靴迫,你只需要使用 [顯示文本](鏈接地址) 這樣的語法即可楼誓,例如:

[簡書](http://www.reibang.com)

在 Markdown 中,插入圖片不需要其他按鈕主守,你只需要使用 [圖片上傳失敗...(image-abcaf9-1601363065976)] 這樣的語法即可阁猜,例如:

![](http://upload-images.jianshu.io/upload_images/259-0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

注:插入圖片的語法和鏈接的語法很像,只是前面多了一個 黄刚!民效。

插入鏈接和圖片的案例截圖:

image

引用

在我們寫作的時候經(jīng)常需要引用他人的文字涛救,這個時候引用這個格式就很有必要了检吆,在 Markdown 中程储,你只需要在你希望引用的文字前面加上 > 就好了,例如:

> 一盞燈摊灭, 一片昏黃败徊; 一簡書, 一杯淡茶煤杀。 守著那一份淡定沪哺, 品讀屬于自己的寂寞。 保持淡定酥泛, 才能欣賞到最美麗的風(fēng)景嫌拣! 保持淡定呆躲, 人生從此不再寂寞。

注:> 和文本之間要保留一個字符的空格灰瞻。

最終顯示的就是:

一盞燈辅甥, 一片昏黃; 一簡書要销, 一杯淡茶夏块。 守著那一份淡定纤掸, 品讀屬于自己的寂寞浑塞。 保持淡定酌壕, 才能欣賞到最美麗的風(fēng)景! 保持淡定卵牍, 人生從此不再寂寞辽慕。

引用的案例截圖:

image

粗體和斜體

Markdown 的粗體和斜體也非常簡單,用兩個 * 包含一段文本就是粗體的語法公浪,用一個 * 包含一段文本就是斜體的語法船侧。例如:

 *一盞燈*, 一片昏黃预柒;**一簡書**袁梗, 一杯淡茶。 守著那一份淡定淋袖, 品讀屬于自己的寂寞锯梁。 保持淡定, 才能欣賞到最美麗的風(fēng)景剥懒! 保持淡定合敦, 人生從此不再寂寞。

最終顯示的就是下文壁却,其中「一盞燈」是斜體,「一簡書」是粗體:

一盞燈赔硫, 一片昏黃盐肃;一簡書, 一杯淡茶推盛。 守著那一份淡定谦铃, 品讀屬于自己的寂寞。 保持淡定瘪菌, 才能欣賞到最美麗的風(fēng)景嘹朗! 保持淡定屹培, 人生從此不再寂寞。

粗體和斜體的案例截圖:

image

代碼引用

需要引用代碼時蓄诽,如果引用的語句只有一段溜歪,不分行,可以用 ` 將語句包起來。
如果引用的語句為多行膊爪,可以將```置于這段代碼的首行和末行米酬。
代碼引用的案例截圖:

image

表格

相關(guān)代碼:

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

顯示效果:

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

<p></p>
相關(guān)代碼:

dog | bird | cat
----|------|----
foo | foo  | foo
bar | bar  | bar
baz | baz  | baz

顯示效果:

dog bird cat
foo foo foo
bar bar bar
baz baz baz

<p></p>

顯示鏈接中帶括號的圖片

![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20(n_{i})+1

代碼如下:

![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1


  1. 這里是腳注 ?

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末加派,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子芍锦,更是在濱河造成了極大的恐慌娄琉,老刑警劉巖,帶你破解...
    沈念sama閱讀 222,946評論 6 518
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件票腰,死亡現(xiàn)場離奇詭異女气,居然都是意外死亡炼鞠,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,336評論 3 399
  • 文/潘曉璐 我一進店門完域,熙熙樓的掌柜王于貴愁眉苦臉地迎上來瘩将,“玉大人,你說我怎么就攤上這事肠仪”傅洌” “怎么了?”我有些...
    開封第一講書人閱讀 169,716評論 0 364
  • 文/不壞的土叔 我叫張陵吮蛹,是天一觀的道長拌屏。 經(jīng)常有香客問我倚喂,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 60,222評論 1 300
  • 正文 為了忘掉前任子库,我火速辦了婚禮仑嗅,結(jié)果婚禮上喧兄,老公的妹妹穿的比我還像新娘。我一直安慰自己浑彰,他們只是感情好拯辙,可當(dāng)我...
    茶點故事閱讀 69,223評論 6 398
  • 文/花漫 我一把揭開白布涯保。 她就那樣靜靜地躺著,像睡著了一般夕春。 火紅的嫁衣襯著肌膚如雪及志。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 52,807評論 1 314
  • 那天率寡,我揣著相機與錄音倚搬,去河邊找鬼。 笑死捅僵,一個胖子當(dāng)著我的面吹牛眨层,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 41,235評論 3 424
  • 文/蒼蘭香墨 我猛地睜開眼伊佃,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了塞祈?” 一聲冷哼從身側(cè)響起帅涂,我...
    開封第一講書人閱讀 40,189評論 0 277
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎斯议,沒想到半個月后醇锚,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 46,712評論 1 320
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,775評論 3 343
  • 正文 我和宋清朗相戀三年液肌,在試婚紗的時候發(fā)現(xiàn)自己被綠了鸥滨。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 40,926評論 1 353
  • 序言:一個原本活蹦亂跳的男人離奇死亡吝秕,死狀恐怖空幻,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情约郁,我是刑警寧澤但两,帶...
    沈念sama閱讀 36,580評論 5 351
  • 正文 年R本政府宣布谨湘,位于F島的核電站芥丧,受9級特大地震影響坊罢,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜物遇,卻給世界環(huán)境...
    茶點故事閱讀 42,259評論 3 336
  • 文/蒙蒙 一询兴、第九天 我趴在偏房一處隱蔽的房頂上張望起趾。 院中可真熱鬧,春花似錦阳掐、人聲如沸缭保。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,750評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽钳恕。三九已至,卻和暖如春厘肮,著一層夾襖步出監(jiān)牢的瞬間睦番,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,867評論 1 274
  • 我被黑心中介騙來泰國打工巩检, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留示启,地道東北人。 一個月前我還...
    沈念sama閱讀 49,368評論 3 379
  • 正文 我出身青樓迟螺,卻偏偏與公主長得像,于是被迫代替她去往敵國和親劳跃。 傳聞我的和親對象是個殘疾皇子浙垫,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 45,930評論 2 361