Markdown 語法說明手冊
2018-07-20 來源：編程學習網(wǎng)
Markdown 是一種輕量級標記語言，能將文本換成有效的XHTML(或者HTML)文檔，它的目標是實現(xiàn)易讀易寫，成為一種適用于網(wǎng)絡的書寫語言。
Markdown 語法簡潔明了，易于掌握，所以用它來寫作是件既效率又舒服的事情。我們所熟知的和一些大型CMS，如Joomla!、Drupal等都能很好的支持Markdown。我是因為寫GitHub項目庫中的Readme才開始接觸Markdown。
Markdown 不是想要取代 HTML，甚至也沒有要和它相近，它的語法種類很少，只對應 HTML 標記的一小部分。Markdown 的構(gòu)想不是要使得 HTML 文檔更容易書寫。在我看來， HTML 已經(jīng)很容易寫了。Markdown 的理念是，能讓文檔更容易讀、寫和隨意改。HTML 是一種發(fā)布的格式，Markdown 是一種書寫的格式。就這樣，Markdown 的格式語法只涵蓋純文本可以涵蓋的范圍。
Headers 標題：
|
# H1
## H2
### H3
#### H4
##### H5
###### H6
另外，H1和H2還能用以下方式顯示：
一級標題
===
二級標題
---
|
Emphasis 文本強調(diào)：
|
*斜體* or _強調(diào)_
**加粗** or __加粗__
***粗斜體*** or ___粗斜體__
但是，如果你的 * 和 _ 兩邊都有空白的話，它們就只會被當成普通的符號：這是一段* 文本強調(diào) *的說明示例。
如果要在文字前后直接插入普通的星號或底線，你可以用反斜線（轉(zhuǎn)義符）：\*this text is surrounded by literal asterisks\*
|
Lists 列表：
|
Unordered 無序列表：
* 無序列表
* 子項
* 子項
+ 無序列表
+ 子項
+ 子項
- 無序列表
- 子項
- 子項
Ordered 有序列表：
1. 第一行
2. 第二行
3. 第三行
1. 第一行
- 第二行
- 第三行
組合：
* 產(chǎn)品介紹（子項無項目符號）
此時子項，要以一個制表符或者4個空格縮進
* 產(chǎn)品特點
1. 特點1
- 特點2
- 特點3
* 產(chǎn)品功能
1. 功能1
- 功能2
- 功能3
可有時我們會出現(xiàn)這樣的情況，首行內(nèi)容是以日期或數(shù)字開頭：2013. 公司年度目標。
為了避免也被轉(zhuǎn)化成有序列表，我們可以在"."前加上反斜杠（轉(zhuǎn)義符）：2013\. 公司年度目標。
|
Links 連接（title為可選項）：
|
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 引用存儲文件：
[link text](../path/file/readme.text "title text")
還能這樣使用：
[link text][]
[link text]: http://www.reddit.com
Email 郵件：
<[email protected]>
|
Images 圖片：
|
Inline-style 內(nèi)嵌方式：
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 代碼和語法高亮：
|
標記一小段行內(nèi)代碼：
本文是一篇介紹`Markdown`的語法的文章
如果高亮的內(nèi)容包含`號，可以這樣寫：
`` `包裹起來` ``
語法高亮：
```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ū)塊)：
|
在該行開頭縮進4個空格或一個制表符(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個或2個以上的空格，也可以使用</br>標簽
第一行文字，
第二行文字
|
Horizontal Rules 水平分割線：
|
***
* * *
- - -
|
Escape character 轉(zhuǎn)義符(反斜杠)：
|
Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強調(diào)效果，你可以在星號的前面加上反斜杠：
\*literal asterisks\*
Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號：
\反斜杠 `反引號 *星號 _下劃線 {}花括號 []方括號 ()括弧 #井字號 +加號 -減號 .英文句 !感嘆號
|
Additional 補充：
|
Markdown也支持傳統(tǒng)的HTML標簽。
比如一個鏈接，你不太喜歡Markdown的寫法，也可以直接寫成<a >百度</a>
|
Markdown官網(wǎng)：http://daringfireball.net/projects/markdown/
參考資料：http://markdown.tw/
Markdown在線編輯器：
Dillinger：http://dillinger.io/
Markdown Here：http://markdown-here.com/livedemo.html
版權(quán)申明：本站文章部分自網(wǎng)絡，如有侵權(quán)，請聯(lián)系：west999com@outlook.com
特別注意：本站所有轉(zhuǎn)載文章言論不代表本站觀點！
本站所提供的圖片等素材，版權(quán)歸原作者所有，如需使用，請與原作者聯(lián)系。
