Markdown 基礎語法

Markdown語法總結

一.標題

1. 兩個= 或者兩個- 對應1、2階標題
This is an H1(=最高階標題)
==
This is an H2(-第二階標題)
--

對應效果:

This is an H1(=最高階標題)
==
This is an H2(-第二階標題)
--

2.在行首插入 1 到 6 個 # 蕴侣,對應到標題 1 到 6 階
# 這是 H1
## 這是 H2
###### 這是 H6

對應效果

這是 H1

這是 H2

這是 H6


二.區(qū)塊引用 Blockquotes

1.每行話前都加>

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.

對應的效果如下:

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.

2.整個段落的第一句話前加>

> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus aqipiscing.

對應的效果如下:

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus aqipiscing.

3.區(qū)塊引用可以嵌套(例如:引用內的引用),只要根據(jù)層次加上不同數(shù)量的,注意中間加個>分割滞项。
> This is the first level of quoting.
>
> > This is nested block quote.
>>>遞減時中間加個>狭归,如果不加的話,會一直保持最后的縮進
> 
>>This is nested block quote.
> Back to the first level.

This is the first level of quoting.

This is nested block quote.

遞減時中間加個">"文判,如果不加的話过椎,會一直保持最后的縮進

This is nested block quote.
Back to the first level.

4.引用的區(qū)塊內也可以使用其他的 Markdown 語法,包括標題戏仓、列表疚宇、代碼區(qū)塊等:
> ## 這是一個標題。
> 1.  這是第一行列表項赏殃。
> 2.  這是第二行列表項敷待。

> 給出一些例子代碼:
> 
>    return shell_exec("echo $input | $markdown_script");  (最前邊要有4個空格)

對應效果:

這是一個標題。

  1. 這是第一行列表項仁热。
  2. 這是第二行列表項榜揖。

給出一些例子代碼:

return shell_exec("echo $input | $markdown_script");


三.列表

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

1.無序列表使用星號抗蠢、加號或是減號作為列表標記:
* Red    
- Green
+ Blue
  • Red
  • Green
  • Blue
2.有序列表則使用數(shù)字接著一個英文句點:
1. Bird   
2. McHale
3. Parish
  1. Bird
  2. McHale
  3. Parish

你可以完全不用在意數(shù)字的正確性举哟,建議第一個項目最好還是從 1. 開始。

四.代碼區(qū)塊

1.使用 <pre> 和 <code> 標簽來把代碼區(qū)塊包起來迅矛。
<pre> 代碼塊 </pre>
<code>單行代碼</code>  

效果如下妨猩,簡書不支持這種語法:
<pre> 代碼塊格式 </pre>
<code>單行代碼格式</code>

2.使用反引號“`”包單行代碼
`單行代碼格式`  

單行代碼格式

3.代碼區(qū)使用反引號"`"的方式就是用"``"將"`"包起來。
A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``

轉換成的效果如下:

A single backtick in a code span: `
A backtick-delimited string in a code span: `foo`

4.使用三個反引號"```"包代碼塊秽褒,且前后的3個反引號各占一行壶硅。
```
代碼塊
```

效果如下

代碼塊
5.也可以只要簡單地縮進 4 個空格或是 1 個制表符就可以。
    這是一個代碼區(qū)塊销斟。

Markdown 轉換成如下效果:

這是一個代碼區(qū)塊庐椒。

且每行一階的縮進(4 個空格或是 1 個制表符)岩调,都會被移除查近。一個代碼區(qū)塊會一直持續(xù)到?jīng)]有縮進的那一行(或是文件結尾)襟锐。

6.代碼塊內特殊字符不會起作用约炎。

代碼區(qū)塊中戚揭,一般的 Markdown 語法不會被轉換蹭劈,像是星號便只是星號厌处,這表示你可以很容易地以 Markdown 語法撰寫 Markdown 語法相關的文件侦另。


五.分割線

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

***

*****

- - -

---------------



六.字體樣式

1.強調担败,Markdown 使用星號(*)和底線(_)作為標記強調字詞的符號,效果如下:
*single asterisks斜體*    
_single underscores斜體(有的是下劃線)_
**double asterisks粗體**
__double underscores粗體__

會轉成:

single asterisks斜體
single underscores斜體(有的是下劃線)
double asterisks粗體
double underscores粗體

你可以隨便用你喜歡的樣式镰官,唯一的限制是提前,你用什么符號開啟標簽,就要用什么符號結束泳唠。

2.強調也可以直接插在文字中間:

un**frigging**believable

unfriggingbelievable

3.文本兩端增加~~可以作為刪除線:
~~DeleteLine~~

轉換的效果如下:
DeleteLine

4.文本兩端增加==可以作為高亮:
==高亮==(簡書不支持)

==高亮==

5.上下標文字:
這是<sup>上標文字</sup>
這是<sub>下標文字</sub>

這是上標文字
這是下標文字



七.反斜杠

Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號狈网,比如:
\literal asterisks\*
轉換成的效果如下(
只是展示沒有轉成斜體的語法):

*literal asterisks*

Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:

\ 反斜線;  ` 反引號;  * 星號;  _ 底線;  {} 花括號;  [] 方括號;  () 括弧;
# 井字號;  + 加號;  - 減號;  . 英文句點;  ! 驚嘆號;

八.表格

表格的樣式最重要的就是第二行的占位符。

文本類型 | 文本類型| 文本類型
:-----|:------:|-----:
居左文本 | 居中文本 | 居右文本
文本類型 文本類型 文本類型
居左文本 居中文本 居右文本


九.超鏈接

Markdown 支持兩種形式的鏈接語法: 行內式和參考式兩種形式笨腥。不管是哪一種拓哺,鏈接文字都是用 [方括號] 來標記。

1.行內式的鏈接脖母。
這是 [百度](http://baidu.com/ "百度") 的鏈接士鸥,這也是[百度](http://baidu.com/) 鏈接.

轉換成的效果如下:

這是 百度 的鏈接,這也是百度 鏈接.

2.可使用相對路徑鏈接到相同主機的資源谆级。

See my [本地資源名](/相對路徑/) page for details.

轉化成的效果如下:

See my 本地資源名 page for details.

3.參考式鏈接,需要鏈接內容配合烤礁。
This is [百度][百度ID] reference-style link. 
This is [百度] [百度IDI] reference-style link.( 兩個方括號之間加個空格鍵也可以)

(鏈接內容,通過ID鏈接肥照,鏈接內容會隱藏)
[百度ID]: http://baidu.com/  "百度Title"
[百度IDI]: http://baidu.com/  

轉換成的效果如下:

This is 百度 reference-style link.
This is 百度 reference-style link.( 兩個方括號之間加個空格鍵也可以)


十.圖片

Markdown 使用一種和鏈接很相似的語法來標記圖片脚仔,同樣也允許兩種樣式: 行內式和參考式。

1.行內式的圖片語法:
語法示例: ![圖片下方文字](圖片地址 "圖片title") 

![bloakChain](https://ss0.bdstatic.com/70cFvHSh_Q1YnxGkpoWK1HF6hhy/it/
u=702257389,1274025419&fm=27&gp=0.jpg)

轉化成的效果如下:

bloakChain

圖片title可有可無建峭。有些語法圖片下方文字不展示玻侥。

2.參考式的圖片語法:
![bloakChain][imageId]

[imageId]: https://ss0.bdstatic.com/70cFvHSh_Q1YnxGkpoWK1HF6hhy/it/
u=702257389,1274025419&fm=27&gp=0.jpg "區(qū)塊鏈"
bloakChain
bloakChain

到目前為止决摧, Markdown 還沒有辦法指定圖片的寬高亿蒸,如果你需要的話,你可以使用普通的 <img> 標簽掌桩。



十一.腳注和注釋

1.使用"[^]"定義腳注边锁,示例如下:
腳注[^1]為什么在上邊?
[^1]: 因為這個注釋會在文章的最后出現(xiàn)

腳注[1]為什么在上邊波岛?

2.注釋只在文本編輯時出現(xiàn):
<!--注釋-->

右側使用了注釋茅坛,但你看不見:



十二.Markdown中常用的Html標簽

1.字體(簡書不支持)
<font face="微軟雅黑" color="red" size="6">字體及字體顏色和大小</font>
<font color="#0000ff">字體顏色</font>
2.換行符
第一行
第二行 <br/>
使用換行符號\<br>后

第一行
第二行

使用換行符號<br>后

3.文本對齊方式(簡書不支持)
<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>
4.下劃線(簡書不支持)
<u>下劃線文本</u>


十三.任務列表(簡書不支持)

任務列表的內容支持其他格式的markdown語法

- [ ] 未選中的選項 [百度鏈接](http://baidu.com),__強調__
- [x] 選中的選項 

效果如下:

  • [ ] 未選中的選項 百度鏈接则拷,強調
  • [x] 選中的選項


十四.自動鏈接和目錄

1.自動鏈接

Markdown 支持以比較簡短的自動鏈接形式來處理網(wǎng)址和電子郵件信箱贡蓖,只要是用方括號包起來, 就會自動把它轉成鏈接煌茬。例如:

網(wǎng)址: <http://example.com/>
郵箱:   <address@example.com>

Markdown 會轉為:
網(wǎng)址:http://example.com/
郵箱: address@example.com


  1. 因為這個注釋會在文章的最后出現(xiàn) ?

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末斥铺,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子坛善,更是在濱河造成了極大的恐慌晾蜘,老刑警劉巖邻眷,帶你破解...
    沈念sama閱讀 216,402評論 6 499
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異剔交,居然都是意外死亡肆饶,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,377評論 3 392
  • 文/潘曉璐 我一進店門岖常,熙熙樓的掌柜王于貴愁眉苦臉地迎上來驯镊,“玉大人,你說我怎么就攤上這事腥椒“⒄” “怎么了?”我有些...
    開封第一講書人閱讀 162,483評論 0 353
  • 文/不壞的土叔 我叫張陵笼蛛,是天一觀的道長洒放。 經(jīng)常有香客問我,道長滨砍,這世上最難降的妖魔是什么往湿? 我笑而不...
    開封第一講書人閱讀 58,165評論 1 292
  • 正文 為了忘掉前任,我火速辦了婚禮惋戏,結果婚禮上领追,老公的妹妹穿的比我還像新娘。我一直安慰自己响逢,他們只是感情好绒窑,可當我...
    茶點故事閱讀 67,176評論 6 388
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著舔亭,像睡著了一般些膨。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上钦铺,一...
    開封第一講書人閱讀 51,146評論 1 297
  • 那天订雾,我揣著相機與錄音,去河邊找鬼矛洞。 笑死洼哎,一個胖子當著我的面吹牛,可吹牛的內容都是我干的沼本。 我是一名探鬼主播噩峦,決...
    沈念sama閱讀 40,032評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼抽兆!你這毒婦竟也來了识补?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 38,896評論 0 274
  • 序言:老撾萬榮一對情侶失蹤郊丛,失蹤者是張志新(化名)和其女友劉穎李请,沒想到半個月后瞧筛,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,311評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡导盅,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,536評論 2 332
  • 正文 我和宋清朗相戀三年较幌,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片白翻。...
    茶點故事閱讀 39,696評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡乍炉,死狀恐怖,靈堂內的尸體忽然破棺而出滤馍,到底是詐尸還是另有隱情岛琼,我是刑警寧澤,帶...
    沈念sama閱讀 35,413評論 5 343
  • 正文 年R本政府宣布巢株,位于F島的核電站槐瑞,受9級特大地震影響,放射性物質發(fā)生泄漏阁苞。R本人自食惡果不足惜困檩,卻給世界環(huán)境...
    茶點故事閱讀 41,008評論 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望那槽。 院中可真熱鬧悼沿,春花似錦、人聲如沸骚灸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽甚牲。三九已至义郑,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間鳖藕,已是汗流浹背魔慷。 一陣腳步聲響...
    開封第一講書人閱讀 32,815評論 1 269
  • 我被黑心中介騙來泰國打工只锭, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留著恩,地道東北人。 一個月前我還...
    沈念sama閱讀 47,698評論 2 368
  • 正文 我出身青樓蜻展,卻偏偏與公主長得像喉誊,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子纵顾,可洞房花燭夜當晚...
    茶點故事閱讀 44,592評論 2 353

推薦閱讀更多精彩內容