Markdown 是一種輕量級(jí)標(biāo)記語(yǔ)言,能將文本換成有效的XHTML(或者HTML)文檔涮阔,它的目標(biāo)是實(shí)現(xiàn)易讀易寫猜绣,成為一種適用于網(wǎng)絡(luò)的書寫語(yǔ)言。
Markdown 語(yǔ)法簡(jiǎn)潔明了澎语,易于掌握途事,所以用它來(lái)寫作是件既效率又舒服的事情。我們所熟知的和一些大型CMS擅羞,如Joomla!尸变、Drupal等都能很好的支持Markdown。我是因?yàn)閷慓itHub項(xiàng)目庫(kù)中的Readme才開(kāi)始接觸Markdown减俏。
Markdown 不是想要取代 HTML召烂,甚至也沒(méi)有要和它相近,它的語(yǔ)法種類很少娃承,只對(duì)應(yīng) HTML 標(biāo)記的一小部分奏夫。Markdown 的構(gòu)想不是要使得 HTML 文檔更容易書寫。在我看來(lái)历筝, HTML 已經(jīng)很容易寫了酗昼。Markdown 的理念是,能讓文檔更容易讀梳猪、寫和隨意改麻削。HTML 是一種發(fā)布的格式,Markdown 是一種書寫的格式春弥。就這樣呛哟,Markdown 的格式語(yǔ)法只涵蓋純文本可以涵蓋的范圍。
Headers 標(biāo)題:
# H1
## H2
### H3
#### H4
##### H5
###### H6
H1
H2
H3
H4
H5
H6
另外匿沛,H1和H2還能用以下方式顯示:
一級(jí)標(biāo)題
一級(jí)標(biāo)題
===
二級(jí)標(biāo)題
二級(jí)標(biāo)題
---
Emphasis 文本強(qiáng)調(diào):
*斜體* or _強(qiáng)調(diào)_
**加粗** or__加粗__
***粗斜體*** or ___粗斜體___
但是扫责,如果你的 * 和 _ 兩邊都有空白的話,它們就只會(huì)被當(dāng)成普通的符號(hào):這是一段* 文本強(qiáng)調(diào) *的說(shuō)明示例逃呼。
如果要在文字前后直接插入普通的星號(hào)或底線鳖孤,你可以用反斜線(轉(zhuǎn)義符):*this text is surrounded by literal asterisks*
Lists 列表:
Unordered 無(wú)序列表:
* 無(wú)序列表
* 子項(xiàng)
* 子項(xiàng)
+ 無(wú)序列表
+ 子項(xiàng)
+ 子項(xiàng)
- 無(wú)序列表
- 子項(xiàng)
- 子項(xiàng)
Ordered 有序列表:
- 第一行
- 第二行
- 第三行
\1. 第一行
- 第二行
- 第三行
- 第一行
- 第二行
- 第三行
組合:
* 產(chǎn)品介紹(子項(xiàng)無(wú)項(xiàng)目符號(hào))
此時(shí)子項(xiàng),要以一個(gè)制表符或者4個(gè)空格縮進(jìn)
* 產(chǎn)品特點(diǎn)
\ 1. 特點(diǎn)1
- 特點(diǎn)2
- 特點(diǎn)3
* 產(chǎn)品功能
\ 1. 功能1
- 功能2
- 功能3
可有時(shí)我們會(huì)出現(xiàn)這樣的情況抡笼,首行內(nèi)容是以日期或數(shù)字開(kāi)頭:2013. 公司年度目標(biāo)苏揣。
為了避免也被轉(zhuǎn)化成有序列表,我們可以在"."前加上反斜杠(轉(zhuǎn)義符):2013. 公司年度目標(biāo)蔫缸。
Links 連接(title為可選項(xiàng)):
Inline-style 內(nèi)嵌方式:
[link text](https://www.google.com "title text")
Reference-style 引用方式:
[link text][id]
[id]: https://www.mozilla.org "title text"
Relative reference to a repository file 引用存儲(chǔ)文件:
[link text](../path/file/readme.text "title text")
還能這樣使用:
[link text][]
[link text]: http://www.reddit.com
Email 郵件:
example@example.com
Images 圖片:
Inline-style 內(nèi)嵌方式:
![alt text](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "title text")
Reference-style 引用方式:
![alt text][logo]
[logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "title text"
Code and Syntax Highlighting 代碼和語(yǔ)法高亮:
標(biāo)記一小段行內(nèi)代碼:
本文是一篇介紹`Markdown`的語(yǔ)法的文章
如果高亮的內(nèi)容包含`號(hào)腿准,可以這樣寫:
`` `包裹起來(lái)` ``
語(yǔ)法高亮:
```html
<div>Syntax Highlighting</div>
```
```css
body{font-size:12px}
```
```javascript
var s = "JavaScript syntax highlighting";
alert(s);
```
```php
<?php
echo "hello, world!";
?>
```
```python
s = "Python syntax highlighting"
print s
```
Block Code 代碼分組(代碼區(qū)塊):
在該行開(kāi)頭縮進(jìn)4個(gè)空格或一個(gè)制表符(tab)
<strong>Blockquotes 引用:</strong>
> Email-style angle brackets
> are used for blockquotes.
> > And, they can be nested.
> #### Headers in blockquotes
> * You can quote a list.
> * Etc.
Hard Line Breaks 換行:
在一行的結(jié)尾處加上2個(gè)或2個(gè)以上的空格际起,也可以使用</br>標(biāo)簽
第一行文字拾碌,
第二行文字
Horizontal Rules 水平分割線:
***
* * *
- - -
Escape character 轉(zhuǎn)義符(反斜杠):
Markdown 可以利用反斜杠來(lái)插入一些在語(yǔ)法中有其它意義的符號(hào)吐葱,例如:如果你想要用星號(hào)加在文字旁邊的方式來(lái)做出強(qiáng)調(diào)效果,你可以在星號(hào)的前面加上反斜杠:
\*literal asterisks\*
Markdown 支持以下這些符號(hào)前面加上反斜杠來(lái)幫助插入普通的符號(hào):
\反斜杠 `反引號(hào) *星號(hào) _下劃線 {}花括號(hào) []方括號(hào) ()括弧 #井字號(hào) +加號(hào) -減號(hào) .英文句 !感嘆號(hào)