Markdown 是一種輕量級標(biāo)記語言磷仰,創(chuàng)始人為 John Gruber 。它允許人們“使用易讀易寫的純文本格式編寫文檔,然后轉(zhuǎn)換成有效的 XHTML (或者 HTML )文檔”。
1 標(biāo)題
標(biāo)題共六級谢揪,一級標(biāo)題字號最大,字號隨著級別的增加遞減捐凭。leanote 最多支持五級標(biāo)題拨扶,簡書可支持六級。
# 一級標(biāo)題
## 二級標(biāo)題
### 三級標(biāo)題
#### 四級標(biāo)題
##### 五級標(biāo)題
###### 六級標(biāo)題
顯示效果如下:
一級標(biāo)題
二級標(biāo)題
三級標(biāo)題
四級標(biāo)題
五級標(biāo)題
六級標(biāo)題
2 列表
2.1 無序列表
無序列表項前的標(biāo)記符號可以使用*
茁肠、+
或-
患民,標(biāo)記符號后須加至少一個空格。
+ 無序列表項1
- 無序列表項2
* 無序列表項3
顯示效果如下:
- 無序列表項1
- 無序列表項2
- 無序列表項3
2.2 有序列表
有序列表項前加上數(shù)字和一個英文句號垦梆,英文句號后須加至少一個空格匹颤。數(shù)字的大小排序不影響最終顯示的效果。
1. 有序列表項 1
3. 有序列表項 2
8. 有序列表項 3
顯示效果如下:
- 有序列表項1
- 有序列表項2
- 有序列表項3
注:leanote 的 markdown 編輯器托猩,無序和有序列表前還需要添加一個空行印蓖,簡書不需要。
3 注腳
在需要加注的文字后加上[^note]
京腥,即可加上注腳赦肃,具體語法如下所示。注意公浪,這里的腳注1, note2 和 footnote3 可以換成其他文字他宛,只要前后保持一致即可。
使用 Markdown[^腳注1]可以效率地書寫文檔欠气,直接轉(zhuǎn)換成 HTML[^note2]厅各,你可以使用 Leanote[^footnote3] 編輯器進(jìn)行書寫。
(注:leanote 的 markdown 編輯器预柒,以下各個注腳解釋之間還需要用一個空行分隔队塘,簡書不需要)
[^腳注1]:Markdown 是一種純文本標(biāo)記語言
[^note2]:HyperText Markup Language 超文本標(biāo)記語言
[^footnote3]:開源筆記平臺袁梗,支持 Markdown 和筆記直接發(fā)為博文
顯示效果如下:
使用 Markdown[1]可以效率地書寫文檔,直接轉(zhuǎn)換成 HTML[2]憔古,你可以使用 Leanote[3] 編輯器進(jìn)行書寫遮怜。
4 插入鏈接
鏈接可指定 title 屬性,也可省略投放。如定義了 title 屬性,當(dāng)鼠標(biāo)懸停在鏈接文字上時會顯示 title 屬性的值适贸。
[鏈接文字](鏈接地址 "title")
例如:[簡書](http://www.reibang.com/ "簡書官網(wǎng)")
顯示效果如下:
用<>
將鏈接包圍起來灸芳,即自動轉(zhuǎn)換成鏈接。
<http://example.com/>
<address@example.com>
顯示效果如下:
http://example.com/
address@example.com
5 插入圖片
插入圖片的語法為:![](圖片鏈接 圖片title)
拜姿。
- 圖片 alt 是當(dāng)圖片無法顯示時烙样,替代圖片的文字信息,可省略蕊肥。
- 圖片 title 是當(dāng)鼠標(biāo)懸停在圖片上時顯示的文字谒获,可省略。
![宋民咕 魚香肉絲里面沒有肉](http://upload-images.jianshu.io/upload_images/4558002-00c60a9b78e694da.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "宋民咕")
顯示效果如下:
6 區(qū)塊引用
引用文本時壁却,在文本前加>
即可批狱,>
與引用文本之間需保留一個空格。
> 假如生活欺騙了你
> 不要悲傷展东,不要心急
> 憂郁的日子里需要鎮(zhèn)靜
> 相信吧赔硫,快樂的日子將會來臨
> 心兒永遠(yuǎn)向往著未來
> 現(xiàn)在卻常是憂郁
> 一切都是瞬息,一切都將會過去
> 而那過去了的盐肃,就會成為親切的懷戀
顯示效果如下:
假如生活欺騙了你
不要悲傷爪膊,不要心急
憂郁的日子里需要鎮(zhèn)靜
相信吧,快樂的日子將會來臨
心兒永遠(yuǎn)向往著未來
現(xiàn)在卻常是憂郁
一切都是瞬息砸王,一切都將會過去
而那過去了的推盛,就會成為親切的懷戀
區(qū)塊引用可以嵌套(引用內(nèi)的引用),還可以在引用內(nèi)使用其他的 markdown 語法谦铃,例如:
> 宋代歐陽修則云:
> 最佳讀書時間耘成,乃為三上:即**枕上**、**馬上**驹闰、**廁上**凿跳。
> —— *劉真《論讀書》*
顯示效果如下:
宋代歐陽修則云:
最佳讀書時間,乃為三上:即枕上疮方、馬上控嗜、廁上。
—— 劉真《論讀書》
7 粗體骡显、斜體疆栏、加粗斜體和刪除線
具體語法如下:
1. **粗體**
2. *斜體*
3. ***加粗斜體***
4. ~~刪除線~~
顯示效果如下:
- 粗體
- 斜體
- 加粗斜體
刪除線
8 輸入代碼
8.1 輸入單行代碼
輸入單行代碼的語法:`單行代碼`曾掂。顯示效果如下:
var a = 1
8.2 輸入多行代碼
輸入多行代碼的語法如下,在第一行的 ``` 后面加上代碼語言壁顶,leanote 和簡書都能實現(xiàn)語法高亮珠洗。
在每行代碼前輸入四個或四個以上的空格也能實現(xiàn)代碼塊的效果。
```python
class Employee:
empCount = 0
def init(self, name, salary):
self.name = name
self.salary = salary
Employee.empCount += 1
```
顯示效果如下:
class Employee:
empCount = 0
def __init__(self, name, salary):
self.name = name
self.salary = salary
Employee.empCount += 1
9 表格
表格第一行為表頭若专,第二行分隔表頭與表格主體部分许蓖,第三行開始為表格主體部分。
列與列之間以|
分隔调衰。
第二行還可為不同列指定對齊方式膊爪,|:------:|
為居中對齊,|------:|
為右對齊嚎莉,|:------|
為左對齊米酬。
|table |table |table |
|:-----|:------:|------:|
|1 |2 |3 |
|4 |5 |6 |
顯示效果如下:
table | table | table |
---|---|---|
1 | 2 | 3 |
4 | 5 | 6 |
10 分隔線
輸入三個以上的*
、-
和_
即可生成分隔線趋箩,*
赃额、-
和_
之間可插入空格。
***
---
___
顯示效果如下:
11 定義
如果需要對某個名詞的定義作出解釋叫确,可以選用以下語法格式跳芳,目前簡書不支持這個功能,leanote 支持竹勉。
名詞 1
: 定義 1(左側(cè)有一個冒號和四個空格)
leanote 上的顯示效果如下:
12 Html 標(biāo)簽
leanote 支持在 Markdown 語法中嵌套 Html 標(biāo)簽筛严,簡書不支持。譬如饶米,你可以用 Html 寫一個縱跨兩行的表格:
<table>
<tr>
<th rowspan="2">值班人員</th>
<th>星期一</th>
<th>星期二</th>
<th>星期三</th>
</tr>
<tr>
<td>李強(qiáng)</td>
<td>張明</td>
<td>王平</td>
</tr>
</table>
leanote 上的顯示效果如下:
也可以通過 img 標(biāo)簽插入圖片桨啃,利用 img 標(biāo)簽的 height 和 width 屬性來設(shè)置圖片的高度和寬度。
![](http://upload-images.jianshu.io/upload_images/4558002-73942e9b78c2b21e.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
leanote 上的顯示效果如下:
13 目錄
通過 [TOC]
在文檔中插入目錄檬输,簡書暫不支持照瘾。leanote 上的顯示效果如下:
14 其他
想更多地了解和學(xué)習(xí) markdown,可參閱以下資料: