1汉买、定義:
Markdown 是一種輕量級(jí)標(biāo)記語(yǔ)言瓷蛙,創(chuàng)始人為約翰·格魯伯(英語(yǔ):John Gruber)即寡。它允許人們“使用易讀易寫的純文本格式編寫文檔,然后轉(zhuǎn)換成有效的XHTML(或者HTML)文檔”笛钝。[4]這種語(yǔ)言吸收了很多在電子郵件中已有的純文本標(biāo)記的特性质况。
2、語(yǔ)法:
1)標(biāo)題
用 Markdown 書寫時(shí)玻靡,只需要在文本前面加上『# 』即可創(chuàng)建一級(jí)標(biāo)題结榄。同理,創(chuàng)建二級(jí)標(biāo)題囤捻、三級(jí)標(biāo)題等只需要增加『# 』個(gè)數(shù)即可潭陪,標(biāo)題字號(hào)相應(yīng)降低,Markdown 共支持六級(jí)標(biāo)題最蕾。如下所示:
# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題
##### 五級(jí)標(biāo)題
###### 六級(jí)標(biāo)題
注:# 和「一級(jí)標(biāo)題」之間建議保留一個(gè)字符的空格,這是最標(biāo)準(zhǔn)的 Markdown 寫法老厌。
2)錨點(diǎn)
Coding 會(huì)針對(duì)每個(gè)標(biāo)題瘟则,在解析時(shí)都會(huì)添加錨點(diǎn) id,如
# 錨點(diǎn)
會(huì)被解析成:
錨點(diǎn)
注意我們添加了一個(gè) user-content- 的前綴枝秤,所以如果要自己添加跳轉(zhuǎn)鏈接要使用 Markdown 的形式醋拧,且鏈接要加一個(gè) user-content- 前綴,如:
[訪問鏈接](#user-content-錨點(diǎn));
3)引用
Markdown 標(biāo)記區(qū)塊引用和 email 中用 『>』的引用方式類似淀弹,只需要在整個(gè)段落的第一行最前面加上 『>』 :
> Coding.net為軟件開發(fā)者提供基于云計(jì)算技術(shù)的軟件開發(fā)平臺(tái)丹壕,包括項(xiàng)目管理,代碼托管薇溃,運(yùn)行空間和質(zhì)量控制等等菌赖。
效果圖如下:
區(qū)塊引用可以嵌套,只要根據(jù)層次加上不同數(shù)量的『>』:
> 這是第一級(jí)引用沐序。>
> > 這是第二級(jí)引用琉用。>
> 現(xiàn)在回到第一級(jí)引用堕绩。
效果圖如下:
引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語(yǔ)法,包括標(biāo)題邑时、列表奴紧、代碼區(qū)塊等:
>## 這是一個(gè)標(biāo)題。> 1. 這是第一行列表項(xiàng)晶丘。> 2. 這是第二行列表項(xiàng)黍氮。>> 給出一些例子代碼:>>returnshell_exec(`echo$input|$markdown_script`);
效果圖如下:
4)列表
列表項(xiàng)目標(biāo)記通常放在最左邊,項(xiàng)目標(biāo)記后面要接一個(gè)字符的空格浅浮。
無(wú)序列表:使用星號(hào)沫浆、加號(hào)或是減號(hào)作為列表標(biāo)記
- Red- Green- Blue
效果圖如下:
有序列表:使用數(shù)字接著一個(gè)英文句點(diǎn)
1. Red2. Green3. Blue
效果圖如下:
如果要在列表項(xiàng)目?jī)?nèi)放進(jìn)引用,那『>』就需要縮進(jìn):
*? Coding.net有以下主要功能:? ? > 代碼托管平臺(tái)? ? > 在線運(yùn)行環(huán)境? ? ? ? > 代碼質(zhì)量監(jiān)控? ? ? ? > 項(xiàng)目管理平臺(tái)
效果圖如下:
代辦列表: 表示列表是否勾選狀態(tài)(注意:[ ] 前后都要有空格)
- [ ] 不勾選- [x] 勾選
效果圖如下:
5)代碼
只要把你的代碼塊包裹在 “` 之間脑题,你就不需要通過無(wú)休止的縮進(jìn)來(lái)標(biāo)記代碼塊了件缸。 在圍欄式代碼塊中,你可以指定一個(gè)可選的語(yǔ)言標(biāo)識(shí)符叔遂,然后我們就可以為它啟用語(yǔ)法著色了他炊。 舉個(gè)例子,這樣可以為一段 Ruby 代碼著色:
```ruby
require'redcarpet'markdown = Redcarpet.new("Hello World!")puts markdown.to_html
```
效果圖如下:
6)強(qiáng)調(diào)
在Markdown中已艰,可以使用 * 和? _? 來(lái)表示斜體和加粗痊末。
斜體:
*Coding,讓開發(fā)更簡(jiǎn)單*_Coding哩掺,讓開發(fā)更簡(jiǎn)單_
效果圖如下:
加粗:
**Coding凿叠,讓開發(fā)更簡(jiǎn)單**__Coding,讓開發(fā)更簡(jiǎn)單__
效果圖如下:
7)自動(dòng)鏈接
方括號(hào)顯示說(shuō)明嚼吞,圓括號(hào)內(nèi)顯示網(wǎng)址盒件, Markdown 會(huì)自動(dòng)把它轉(zhuǎn)成鏈接,例如:
[超強(qiáng)大的云開發(fā)平臺(tái)Coding](http://coding.net)
效果圖如下:
8)表格
在 Markdown 中舱禽,可以制作表格炒刁,例如:
First Header | Second Header | Third Header
------------ | ------------- | ------------
Content Cell | Content Cell? | Content Cell
Content Cell | Content Cell? | Content Cell
效果圖如下:
或者也可以讓表格兩邊內(nèi)容對(duì)齊,中間內(nèi)容居中誊稚,例如:
First Header | Second Header | Third Header
:-----------? ? ? |? :-----------:? ? ? ? ? |? -----------:
Left? ? ? ? ? ? ? | Center? ? ? ? ? ? ? ? | Right
Left? ? ? ? ? ? ? | Center? ? ? ? ? ? ? ? | Right
效果圖如下:
9)分割線
在 Markdown 中翔始,可以使用 3 個(gè)以上『-』符號(hào)制作分割線,例如:
這是分隔線上部分內(nèi)容---這是分隔線上部分內(nèi)容
效果圖如下:
10)圖片
Markdown 使用了類似鏈接的語(yǔ)法來(lái)插入圖片, 包含兩種形式: 內(nèi)聯(lián) 和 引用.
內(nèi)聯(lián)圖片語(yǔ)法如下:
![Alt text](/path/to/img.jpg)
或
![Alt text](/path/to/img.jpg "Optional title")
也就是:
一個(gè)驚嘆號(hào)『!』
接著一個(gè)方括號(hào)里伯,里面是圖片的替代文字
接著一個(gè)普通括號(hào)城瞎,里面是圖片的網(wǎng)址,最后還可以用引號(hào)包住并加上 選擇性的『title’』文字疾瓮。
引用圖片語(yǔ)法如下:
![Alt text][id]
『id』 是圖片引用的名稱. 圖片引用使用鏈接定義的相同語(yǔ)法:
[id]: url/to/image "Optional title attribute"
11)
詳解請(qǐng)看:http://wowubuntu.com/markdown/