轉(zhuǎn)載于:http://sidney001.top/2016/11/17/Markdown語(yǔ)法/
主要內(nèi)容
Markdown是什么?
為什么要使用它?
怎么使用?
都誰(shuí)在用?####
感覺有意思?不怕你看見,就怕你試試
正文
1. Markdown是什么?
Markdown是一種輕量級(jí)標(biāo)記語(yǔ)言,它以純文本形式(易讀、易寫、易更改)編寫文檔,并最終以HTML格式發(fā)布。
Markdown也可以理解為將以MARKDOWN語(yǔ)言編寫的語(yǔ)言轉(zhuǎn)換成HTML內(nèi)容的工具,最初是一個(gè)perl腳本Markdown.pl。
2. 為什么要使用它?
- 它是易讀(看起開舒服)、易寫(語(yǔ)法簡(jiǎn)單)、易更改純文本。處處體現(xiàn)著極簡(jiǎn)主義的影子。
- 兼容HTML,可以轉(zhuǎn)換為HTML格式發(fā)布。
- 跨平臺(tái)使用。
- 越來越多的網(wǎng)站支持Markdown。
- 更方便清晰的組織你的電子郵件。(Markdown-here, Airmail)
- 擺脫Word(我不是認(rèn)真的)。
3. 怎么使用?
如果不算擴(kuò)展,Markdown的語(yǔ)法絕對(duì)簡(jiǎn)單到讓你愛不釋手。
廢話太多,下面正文,Markdown語(yǔ)法主要分為如下幾大部分:
標(biāo)題,段落,區(qū)塊引用,代碼區(qū)塊,強(qiáng)調(diào),列表,分割線,鏈接,圖片,反斜杠 \,符號(hào)'`'。
3.1 標(biāo)題
兩種形式:
1)使用=和-標(biāo)記一級(jí)和二級(jí)標(biāo)題。
一級(jí)標(biāo)題
=========
二級(jí)標(biāo)題
---------
效果:
一級(jí)標(biāo)題
二級(jí)標(biāo)題
2)使用#,可表示1-6級(jí)標(biāo)題。
# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題
##### 五級(jí)標(biāo)題
###### 六級(jí)標(biāo)題
效果:
一級(jí)標(biāo)題
二級(jí)標(biāo)題
三級(jí)標(biāo)題
四級(jí)標(biāo)題
五級(jí)標(biāo)題
六級(jí)標(biāo)題
3.2 段落
段落的前后要有空行,所謂的空行是指沒有文字內(nèi)容。若想在段內(nèi)強(qiáng)制換行的方式是使用兩個(gè)以上空格加上回車(引用中換行省略回車)。
3.3 區(qū)塊引用
在段落的每行或者只在第一行使用符號(hào)>,還可使用多個(gè)嵌套引用,如:
> 區(qū)塊引用
>> 嵌套引用
效果:
區(qū)塊引用
嵌套引用
3.4 代碼區(qū)塊
代碼區(qū)塊的建立是在每行加上4個(gè)空格或者一個(gè)制表符(如同寫代碼一樣)。如
普通段落:
void main()
{
printf("Hello, Markdown.");
}
代碼區(qū)塊:
void main()
{
printf("Hello, Markdown.");
}
注意:需要和普通段落之間存在空行。
3.5 強(qiáng)調(diào)
在強(qiáng)調(diào)內(nèi)容兩側(cè)分別加上*或者_,如:
*斜體*,_斜體_
**粗體**,__粗體__
效果:
斜體,斜體
粗體,粗體
3.6 列表
使用·、+、或-標(biāo)記無(wú)序列表,如:
-(+*) 第一項(xiàng)
-(+*) 第二項(xiàng)
- (+*)第三項(xiàng)
注意:標(biāo)記后面最少有一個(gè)空格或制表符。若不在引用區(qū)塊中,必須和前方段落之間存在空行。
效果:
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
有序列表的標(biāo)記方式是將上述的符號(hào)換成數(shù)字,并輔以.,如:
1 . 第一項(xiàng)
2 . 第二項(xiàng)
3 . 第三項(xiàng)
效果:
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
3.7 分割線
分割線最常使用就是三個(gè)或以上*,還可以使用-和_。
3.8 鏈接
鏈接可以由兩種形式生成:行內(nèi)式和參考式。
行內(nèi)式:
[younghz的Markdown庫(kù)](https:://github.com/younghz/Markdown "Markdown")。
效果:
參考式:
[younghz的Markdown庫(kù)1][1]
[younghz的Markdown庫(kù)2][2]
[1]:https:://github.com/younghz/Markdown "Markdown"
[2]:https:://github.com/younghz/Markdown "Markdown"
效果:
注意:上述的[1]:https:://github.com/younghz/Markdown "Markdown"不出現(xiàn)在區(qū)塊中。
3.9 圖片
添加圖片的形式和鏈接相似,只需在鏈接的基礎(chǔ)上前方加一個(gè)!。
3.10 反斜杠\
相當(dāng)于反轉(zhuǎn)義作用。使符號(hào)成為普通符號(hào)。
3.11 符號(hào)'`'
起到標(biāo)記作用。如:
`ctrl+a`
效果:
ctrl+a
4. 都誰(shuí)在用?####
Markdown的使用者:
- GitHub
- 簡(jiǎn)書
- Stack Overflow
- Apollo
- Moodle
- 等等
5. 感覺有意思?趁熱打鐵,推薦幾個(gè)工具。
-
Chrome下的stackedit插件可以離線使用,很爽。也不用擔(dān)心平臺(tái)受限。
在線的dillinger.io算是評(píng)價(jià)好的了,可是不能離線使用。 - Windowns下的MarkdownPad也用過,不過免費(fèi)版的體驗(yàn)不是很好。
- Mac下的Mou是國(guó)人貢獻(xiàn)的,口碑很好。推薦。
- Linux下的ReText不錯(cuò)。
其實(shí)在對(duì)語(yǔ)法了如于心的話,直接用編輯器就可以了,腦子里滿滿的都是格式化好的文本啊。
我現(xiàn)在使用馬克飛象 + Markdown-here,先編輯好,然后一鍵格式化,挺方便。
注意:不同的Markdown解釋器或工具對(duì)相應(yīng)語(yǔ)法(擴(kuò)展語(yǔ)法)的解釋效果不盡相同,具體可參見工具的使用說明。
雖然有人想出面搞一個(gè)所謂的標(biāo)準(zhǔn)化的Markdown,[沒想到還惹怒了健在的創(chuàng)始人John Gruber]
(http://blog.codinghorror.com/standard-markdown-is-now-common-markdown/)。
以上基本是所有traditonal markdown的語(yǔ)法。
其它:
列表的使用(非traditonal markdown):
用|表示表格縱向邊界,表頭和表內(nèi)容用-隔開,并可用:進(jìn)行對(duì)齊設(shè)置,兩邊都有:則表示居中,若不加:則默認(rèn)左對(duì)齊。
| 代碼庫(kù) | 鏈接 |
|---|---|
| MarkDown | https://github.com/younghz/Markdown |
| moos-young | https://github.com/younghz/moos-young |
關(guān)于其它擴(kuò)展語(yǔ)法可參見具體工具的使用說明。
Modified based on :younghz's Github