Markdown簡明易讀快速入門中文語法
Author CA3W
基本
Markdown 的目標(biāo)是實(shí)現(xiàn)「易讀易寫」娄帖，最大靈感來源其實(shí)是純文字的電子郵件格式祸穷。
- Markdown 是一種用來寫作的輕量級標(biāo)記語言叔营，
- Markdown 的重點(diǎn)在于有巧，它能讓文件更容易閱讀爸吮、編寫芬膝，
- 兼容 HTML 且自動轉(zhuǎn)換，例如
<和&自動轉(zhuǎn)為<和&形娇。
境界
最高境界：筆下是語法锰霜，心中格式化。
字體
- 使用星號
*和底號_表示<em>標(biāo)簽桐早。
例如：
*斜體（星號）*
_斜體（下劃線）_
斜體（星號）
斜體（下劃線）
- 使用雙星號
**和雙底號__表示<strong>標(biāo)簽癣缅。
例如：
**強(qiáng)調(diào)（星號）**
__強(qiáng)調(diào)（下劃線）__
強(qiáng)調(diào)（星號）
強(qiáng)調(diào)（下劃線）
段落
- 段落的前后要有空行，所謂的空行是指沒有文字內(nèi)容（要點(diǎn)：不能有空格符）哄酝。
例如：
一行文字
又一行文字
空行后再來一行文字
一行文字
又一行文字
空行后再來一行文字
標(biāo)題
- 生成
<h1>-<h6>標(biāo)簽友存，是通過在文字前面加上同等個(gè)數(shù)#符號來實(shí)現(xiàn)。 - 出于美觀陶衅，也可以使用對稱的閉合式標(biāo)題符號屡立。
例如：
# 一口井 h1
## 二口井 h2
### 三口井 h3
#### 四口井 h4
##### 五口井 h5
###### 六口井 h6
列表
-
*，-搀军，+這三個(gè)符號效果都一樣膨俐，這3個(gè)符號被稱為Markdown列表符號勇皇。而有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn)（數(shù)字大小并不會影響輸出序列）。
例如：
* 全星號1
* 全星號2
* 全星號3
***
- 全減號1
- 全減號2
- 全減號3
***
+ 全加號1
+ 全加號2
+ 全加號3
***
1. 有序列表項(xiàng) 一
1. 有序列表項(xiàng) 二
1. 有序列表項(xiàng) 三
***
- [x] 復(fù)選框列表項(xiàng) 一
- [x] 復(fù)選框列表項(xiàng) 二
- [ ] 復(fù)選框列表項(xiàng) 三
***
- [ ] TODO列表
- [ ] 支持子列表嵌套
- [ ] TODO列表列表項(xiàng) 一
- [x] TODO列表列表項(xiàng) 二
- [x] TODO列表列表項(xiàng) 三
- [x] TODO列表列表項(xiàng) 四
- [ ] TODO列表列表項(xiàng) 五
- [ ] TODO列表列表項(xiàng) 六
- [x] TODO列表列表項(xiàng) 七
- 全星號1
- 全星號2
- 全星號3
- 全減號1
- 全減號2
- 全減號3
- 全加號1
- 全加號2
- 全加號3
- 有序列表項(xiàng) 一
- 有序列表項(xiàng) 二
- 有序列表項(xiàng) 三
- [x] 復(fù)選框列表項(xiàng) 一
- [x] 復(fù)選框列表項(xiàng) 二
- [ ] 復(fù)選框列表項(xiàng) 三
- [ ] TODO列表
- [ ] 支持子列表嵌套
- [ ] TODO列表列表項(xiàng) 一
- [x] TODO列表列表項(xiàng) 二
- [x] TODO列表列表項(xiàng) 三
- [x] TODO列表列表項(xiàng) 四
- [ ] TODO列表列表項(xiàng) 五
- [ ] TODO列表列表項(xiàng) 六
- [x] TODO列表列表項(xiàng) 七
兼容：`復(fù)選框` 和 `TODO列表` 的 `復(fù)選框` 部分服務(wù)商不兼容焚刺，會直接顯示 `[x]` `[]`敛摘，不過沒關(guān)系。
引用
-
>符號表示引用檩坚，可簡寫于第一行着撩，也可以每一行都添加。 - 區(qū)塊的引用可以嵌套匾委，只需要在層次數(shù)上加上同等數(shù)量的
>符號拖叙。 - 引用內(nèi)可以使用其他Markdown語法，包括標(biāo)題赂乐、列表薯鳍、代碼區(qū)塊等。
例如：
> 第一行
> 第二行（要點(diǎn)：換行問題挨措，第一行的后面只有2個(gè) ` ` （空格）才能兼容所有平臺）
> > 引用中的引用
第一行
第二行（要點(diǎn)：換行問題挖滤，第一行的后面只有2個(gè)（空格）才能兼容所有平臺）引用中的引用
代碼
- <code>`</code>是表示inline代碼，4個(gè)<code> </code>（空格）來表示縮進(jìn)式代碼段浅役，分別對應(yīng)HTML的
<code>斩松，<pre>標(biāo)簽。也可以使用<code>```</code>來表達(dá)圍欄式代碼塊（GFM語法觉既，部分編輯器不支持）惧盹，并指定他的語言類型，實(shí)現(xiàn)語法高亮瞪讼。圍欄式代碼塊可以大量減少縮進(jìn)的使用钧椰，大規(guī)模的代碼塊使用非常方便。
例如：
inline代碼
`sort()` inline代碼
sort() inline代碼
普通的縮進(jìn)式代碼塊符欠。
<?php
$myArray = array('a' => 'Dog', 'b' => 'Cat');
sort($myArray);
print_r($myArray);
?>
<?php
$myArray = array('a' => 'Dog', 'b' => 'Cat');
sort($myArray);
print_r($myArray);
?>
帶語法高亮的圍欄式代碼塊（GFM語法嫡霞，部分編輯器不支持）。
\`\`\`php
<?php
$myArray = array('a' => 'Dog', 'b' => 'Cat');
sort($myArray);
print_r($myArray);
?>
\`\`\`
<?php
$myArray = array('a' => 'Dog', 'b' => 'Cat');
sort($myArray);
print_r($myArray);
?>
鏈接
- Markdown支持兩種形式的鏈接語法：行內(nèi)式和參考式兩種形式希柿。
例如：
行內(nèi)式鏈接诊沪，是在方括號后面接圓括號即可。
[site](http://localhost "站點(diǎn)標(biāo)題")
參考式鏈接曾撤，是在鏈接文字的括號后面加上另一個(gè)方括號娄徊，在第二個(gè)方括號里面要填入用以辨識鏈接的標(biāo)記。
[site][9527]
[9527]: http://localhost "站點(diǎn)標(biāo)題"
圖片
- Markdown使用一種和鏈接很相似的語法來標(biāo)記圖片盾戴，只是多了一個(gè)
!在最前面，同樣也允許兩種樣式：行內(nèi)式和參考式兵多。 - 目前為止尖啡，Markdown還沒有辦法指定圖片的寬高橄仆，如果你需要的話，你可以使用普通的
<img>標(biāo)簽衅斩。
例如：
行內(nèi)式鏈接盆顾，是在方括號后面接圓括號即可。
github
參考式鏈接畏梆，是在鏈接文字的括號后面加上另一個(gè)方括號您宪，在第二個(gè)方括號里面要填入用以辨識鏈接的標(biāo)記。
![github][GH]
[GH]: https://assets-cdn.github.com/images/modules/logos_page/GitHub-Logo.png "GitHub"
github
使用普通的<img>標(biāo)簽
<img width="200px" src="https://assets-cdn.github.com/images/modules/logos_page/GitHub-Logo.png" alt="Github">
<img width="200px" src="https://assets-cdn.github.com/images/modules/logos_page/GitHub-Logo.png" alt="Github">
分隔線
- 使用三個(gè)以上的
*奠涌、-來建立一個(gè)分隔線宪巨，行內(nèi)不能有其他字符。
例如：
***
上文
下文
表格
- Markdown使用
|和-來繪制表格溜畅，:可控制左對齊捏卓、右對齊及居中。
例如：
| unset | left | center | right |
| ------------- |:------------- |:-------------:| -------------:|
| align: unset | align: left | align: center | align: right |
| 123 | 123 | 456 | 789 |
| 123456 | 123456 | 456789 | others |
| unset | left | center | right |
|---|---|---|---|
| align: unset | align: left | align: center | align: right |
| 123 | 123 | 456 | 789 |
| 123456 | 123456 | 456789 | others |
