寫(xiě)在前面
最近才接觸MarkDown,但是看到各個(gè)教程不是很清楚和全面搭儒,所以寫(xiě)了一個(gè)常用語(yǔ)法教程洗鸵,希望能幫到大家越锈。
基本
- Markdown是一種用來(lái)寫(xiě)作的輕量級(jí)標(biāo)記語(yǔ)言。
- 用標(biāo)記語(yǔ)法膘滨,來(lái)代替常見(jiàn)的排版格式。
- 兼容 HTML代碼稀拐。
- 特殊字符自動(dòng)轉(zhuǎn)換火邓,例如<和&。
字體
使用星號(hào)*和底號(hào)_表示
<em>
標(biāo)簽德撬。
例如:
*斜體* _斜體_
效果:
斜體使用雙星號(hào)
**
和雙底號(hào)__
表示<strong>
標(biāo)簽铲咨。
例如:
**強(qiáng)調(diào)** __強(qiáng)調(diào)__
效果:
強(qiáng)調(diào)
換行
單一段落用空白行。
標(biāo)題
- 生成
<h1>-<h6>
標(biāo)簽蜓洪,是通過(guò)在文字前面加上同等個(gè)數(shù)#
符號(hào)來(lái)實(shí)現(xiàn)纤勒。出于美觀,也可以使用對(duì)稱的閉合式標(biāo)題符號(hào)隆檀。
例如:
### 這是標(biāo)題
### 這是標(biāo)題 ###
效果:
這是標(biāo)題
列表
- *摇天,-,+這三個(gè)符號(hào)效果都一樣恐仑,這3個(gè)符號(hào)被稱為Markdown列表符號(hào)泉坐。而有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn)(數(shù)字大小并不會(huì)影響輸出序列)。
例如:
* 第一行
* 第二行
* 第三行
6. 第四行
5. 第五行
4. 第六行
效果:
- 第一行
- 第二行
- 第三行
- 第四行
- 第五行
- 第六行
引用
-
>
符號(hào)表示引用裳仆,可簡(jiǎn)寫(xiě)于第一行腕让,也可以每一行都添加。 - 區(qū)塊的引用可以嵌套歧斟,只需要在層次數(shù)上加上同等數(shù)量的
>
符號(hào)纯丸。 - 引用內(nèi)可以使用其他Markdown語(yǔ)法,包括標(biāo)題静袖、列表觉鼻、代碼區(qū)塊等。
例如:
> 引用
> > 引用中的引用
效果:
引用
引用中的引用
代碼區(qū)塊
- `是表示inline代碼勾徽,4個(gè)(空格)來(lái)表示縮進(jìn)式代碼段滑凉,分別對(duì)應(yīng)HTML的
<code>``<pre>
標(biāo)簽。也可以使用```來(lái)表達(dá)圍欄式代碼塊(GFM語(yǔ)法喘帚,部分編輯器不支持)畅姊,并指定他的語(yǔ)言類型,實(shí)現(xiàn)語(yǔ)法高亮吹由。圍欄式代碼塊可以大量減少縮進(jìn)的使用若未,大規(guī)模的代碼塊使用非常方便。
帶語(yǔ)法高亮的圍欄式代碼塊(GFM語(yǔ)法倾鲫,部分編輯器不支持)粗合。
<?php $my_array = array('a' => 'Dog', 'b' => 'Cat');
sort($my_array);
print_r($my_array);
?>
鏈接
-
Markdown支持兩種形式的鏈接語(yǔ)法:行內(nèi)式和參考式兩種形式萍嬉。
鏈接內(nèi)容定義的形式為:- 方括號(hào)(前面可以選擇性地加上至多三個(gè)空格來(lái)縮進(jìn)),里面輸入鏈接文字
- 接著一個(gè)冒號(hào)
- 接著一個(gè)以上的空格或制表符
- 接著鏈接的網(wǎng)址
- 選擇性地接著 title 內(nèi)容隙疚,可以用單引號(hào)壤追、雙引號(hào)或是括弧包著
-
行內(nèi)式鏈接,是在方括號(hào)后面接圓括號(hào)即可供屉。 例如:
[騰訊網(wǎng)](http://qq.com "訪問(wèn)騰訊網(wǎng)")
效果:
騰訊網(wǎng)- 參考式鏈接行冰,是在鏈接文字的括號(hào)后面加上另一個(gè)方括號(hào),在第二個(gè)方括號(hào)里面要填入用以辨識(shí) 鏈接的標(biāo)記伶丐。 例如:
[騰訊網(wǎng)][url] [url]: http://qq.com "訪問(wèn)騰訊網(wǎng)"
效果:
騰訊網(wǎng)
- 參考式鏈接行冰,是在鏈接文字的括號(hào)后面加上另一個(gè)方括號(hào),在第二個(gè)方括號(hào)里面要填入用以辨識(shí) 鏈接的標(biāo)記伶丐。 例如:
圖片
- Markdown使用一種和鏈接很相似的語(yǔ)法來(lái)標(biāo)記圖片悼做,只是多了一個(gè)!
在最前面,同樣也允許兩種樣式:行內(nèi)式和參考式哗魂。 - 目前為止肛走,Markdown還沒(méi)有辦法指定圖片的寬高,如果你需要的話录别,你可以使用普通的
<img>
標(biāo)簽朽色。
行內(nèi)式鏈接,是在方括號(hào)后面接圓括號(hào)即可庶灿。 例如:
![圖片](http://i0.hdslb.com/bfs/face/393c4cea7e2e68b04e6cce77a82922458da341c2.jpg "兔子")
效果:
參考式鏈接纵搁,是在鏈接文字的括號(hào)后面加上另一個(gè)方括號(hào),在第二個(gè)方括號(hào)里面要填入用以辨識(shí)鏈接的標(biāo)記往踢。例如:
![圖片][he] [he]: http://p4.music.126.net/HjetWex6kxCE8T6otYl93w==/1415071473584964.jpg "樂(lè)團(tuán)"
效果:
![圖片][he]
[he]:http://p4.music.126.net/HjetWex6kxCE8T6otYl93w==/1415071473584964.jpg "樂(lè)團(tuán)"
分隔線
- 使用三個(gè)以上的*腾誉、-來(lái)建立一個(gè)分隔線,行內(nèi)不能有其他字符峻呕。
例如:
* * *
---
效果:
上文
下文
表格
- Markdown使用
|
和-
來(lái)繪制表格利职,:
可控制左對(duì)齊、右對(duì)齊及居中瘦癌。
例如:
| Title | Description |
| :------ | :--------------------------------: |
| Version | 0.0.1 |
| Editor | [Melo618](mailto:Editor@Email.com) |
效果:
Title | Description |
---|---|
Version | 0.0.1 |
Editor | Melo618 |
轉(zhuǎn)義
- Markdown利用
\
字符來(lái)轉(zhuǎn)義一些在語(yǔ)法中有特殊意義的符號(hào)猪贪。
自動(dòng)鏈接
- Markdown 支持以比較簡(jiǎn)短的自動(dòng)鏈接形式來(lái)處理網(wǎng)址和電子郵件信箱,只要是用尖括號(hào)包起來(lái)讯私, Markdown 就會(huì)自動(dòng)把它轉(zhuǎn)成鏈接热押。一般網(wǎng)址的鏈接文字就和鏈接地址一樣,例如:
<https://google.com/>
效果:
https://google.com/
刪除線
- 例如:
~~刪除~~
效果:刪除