Markdown 的設(shè)計(jì)哲學(xué)
Markdown 的目標(biāo)是實(shí)現(xiàn) 易讀易寫.
不過最需要強(qiáng)調(diào)的便是它的可讀性. 一份使用 Markdown 格式撰寫的文件應(yīng)該可以直接以純文字發(fā)布,并且看起來不會像是由許多標(biāo)簽或是格式指令所構(gòu)成.
Markdown 的語法有個主要的目的:用來作為一種網(wǎng)絡(luò)內(nèi)容的寫作用語.
標(biāo)題
markdown 語法:
#第一級標(biāo)題 `<h1>`
#第二級標(biāo)題`<h2>`
######第六級標(biāo)題`<h6>`
效果如下:
第一級標(biāo)題<h1>
第二級標(biāo)題<h2>
第六級標(biāo)題<h6>
Markdown 語法:
*這些文字會生成`<em>`*
_這些文字會生成`<u>`_
**這些文字會生成`<strong>`**
__這些文字會生成`<strong>`__
快捷鍵:CMD + U
, CMD + I
, CMD + B
效果如下
這些文字會生成<em>
這些文字會生成<u>
這些文字會生成<strong>
這些文字會生成<strong>
列表
無序列表
Markdown 語法:
* 項(xiàng)目一 無序列表`* + 空格鍵`
*項(xiàng)目二
* 項(xiàng)目二的子項(xiàng)目已 無序列表 `TAB + * + 空格鍵`
* 項(xiàng)目二的子項(xiàng)目二
效果如下:
- 項(xiàng)目一 無序列表
* + 空格鍵
- 項(xiàng)目二
- 項(xiàng)目二的子項(xiàng)目一 無序列表
TAB + * + 空格鍵
- 項(xiàng)目二的子項(xiàng)目二
有序列表
Markdown 語法:
1. 項(xiàng)目一 有序列表 `數(shù)字 + . + 空格鍵`
2. 項(xiàng)目二
3. 項(xiàng)目三
1. 項(xiàng)目三的子項(xiàng)目一 有序列表 `TAB + 數(shù)字 + . + 空格鍵`
2. 項(xiàng)目三的子項(xiàng)目二
效果如下:
- 項(xiàng)目一 有序列表
數(shù)字 + . + 空格鍵
- 項(xiàng)目二
- 項(xiàng)目三
- 項(xiàng)目三的子項(xiàng)目一 有序列表
TAB + 數(shù)字 + . + 空格鍵
- 項(xiàng)目三的子項(xiàng)目二
任務(wù)列表(Task lists)
Markdown 語法:
- [ ] 任務(wù)一 未做任務(wù) `- + 空格 + [ ]`
- [x] 任務(wù)二 已做任務(wù) `- + 空格 + [x]`
效果如下:
- [ ] 任務(wù)一 未做任務(wù)
- + 空格 + [ ]
- [x] 任務(wù)二 已做任務(wù)
- + 空格 + [x]
圖片
Markdown 語法:
![GitHub set up](http://upload-images.jianshu.io/upload_images/743671-070a4d040ece6277.gif?imageMogr2/auto-orient/strip)
格式: [站外圖片上傳中……(2)]
效果如下:
鏈接
Markdown 語法:
email <example@example.com>
[GitHub](http://github.com)
自動生成連接 <http://www.github.com/>
效果如下:
Email 連接: example@example.com
連接標(biāo)題Github網(wǎng)站
自動生成連接像: http://www.github.com/ 這樣
區(qū)塊引用
Markdown 語法:
某某說:
> 第一行引用
> 第二行費(fèi)用文字
效果如下:
某某說:
第一行引用
第二行費(fèi)用文字
行內(nèi)代碼
Markdown 語法:
像這樣即可:`<addr>` `code`
效果如下:
像這樣即可:<addr>
code
多行或者一段代碼
Markdown 語法:
```js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
```
效果如下:
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
順序圖或流程圖
Markdown 語法:
```sequence
張三->李四: 嘿撤蟆,小四兒, 寫博客了沒?
Note right of 李四: 李四愣了一下,說:
李四-->張三: 忙得吐血堂污,哪有時(shí)間寫家肯。
```
```flow
st=>start: 開始
e=>end: 結(jié)束
op=>operation: 我的操作
cond=>condition: 確認(rèn)?
st->op->cond
cond(yes)->e
cond(no)->op
```
效果如下:
張三->李四: 嘿敷鸦,小四兒, 寫博客了沒?
Note right of 李四: 李四愣了一下息楔,說:
李四-->張三: 忙得吐血寝贡,哪有時(shí)間寫扒披。
st=>start: 開始
e=>end: 結(jié)束
op=>operation: 我的操作
cond=>condition: 確認(rèn)?
st->op->cond
cond(yes)->e
cond(no)->op
更多請參考:http://bramp.github.io/js-sequence-diagrams/, http://adrai.github.io/flowchart.js/
表格
Markdown 語法:
第一格表頭 | 第二格表頭
--------- | -------------
內(nèi)容單元格 第一列第一格 | 內(nèi)容單元格第二列第一格
內(nèi)容單元格 第一列第二格 多加文字 | 內(nèi)容單元格第二列第二格
效果如下:
第一格表頭 | 第二格表頭 |
---|---|
內(nèi)容單元格 第一列第一格 | 內(nèi)容單元格第二列第一格 |
內(nèi)容單元格 第一列第二格 多加文字 | 內(nèi)容單元格第二列第二格 |
刪除線
Markdown 語法:
加刪除線像這樣用: 刪除這些
效果如下:
加刪除線像這樣用: 刪除這些
分隔線
以下三種方式都可以生成分隔線:
效果如下:
腳注(Footnote)
Markdown 語法:
這是一個腳注:[^sample_footnote]
效果如下:
這是一個腳注:[1]
注釋和閱讀更多
********注******** 閱讀更多的功能只用在生成網(wǎng)站或博客時(shí)圃泡,插入時(shí)注意要后空一行碟案。
-
這里是腳注信息 ?