接觸簡(jiǎn)書有一段時(shí)間了,一直都是看別人的文章,最近突然想自己在這里記錄點(diǎn)文字,昨天嘗試著隨便寫了點(diǎn),無意中發(fā)現(xiàn)Markdown編輯器,覺得還挺有意思的,今天就參考了兩篇文章,一邊學(xué)一邊寫,歡迎大家多多指正。
1、設(shè)置標(biāo)題
Markdown 支持兩種標(biāo)題的語(yǔ)法:1)類 Setext ;2)類 atx 形式。
1)類 Setext 形式,是用底線的形式,利用 = (最高階標(biāo)題)和 - (第二階標(biāo)題),例如:
This is an H1
=============
This is an H2
-------------
輸出顯示如下:
This is an H1
This is an H2
任何數(shù)量的 = 和 - 都可以有效果。
2)類 Atx 形式,則是在行首插入 1 到 6 個(gè) # ,對(duì)應(yīng)到標(biāo)題 1 到 6 階,例如:
# 這是 H1
## 這是 H2
### 這是 H3
輸出顯示如下:
這是 H1
這是 H2
這是 H3
你可以在行尾加上 #,純粹只是美觀用的,而行尾的 # 數(shù)量也不用和開頭一樣,如下:
# 這是 H1 #
## 這是 H2 ##
### 這是 H3 ######
2、區(qū)塊引用
在寫作的時(shí)候,需要引用他人的文字,或者為了突出顯示某一段單獨(dú)的文字,這個(gè)時(shí)候區(qū)塊引用這個(gè)格式就很有必要了,在Markdown中,你只需要在你需要引用或者劃分區(qū)塊的文字前面加上>就好了,例如:
> 自古以來,一個(gè)人要想成功,只有兩個(gè)最基本的動(dòng)力源:興趣或生存。
> 要么你為了自己喜歡的事情去奮斗,要么你被生活所迫去努力,本質(zhì)上沒有其他可能。90 后作為最新的職場(chǎng)一代,之所以這么廣為詬病,就是在于這兩種動(dòng)力從群體意義上被打小閹割掉了。
輸出顯示如下:
自古以來,一個(gè)人要想成功,只有兩個(gè)最基本的動(dòng)力源:興趣或生存。
要么你為了自己喜歡的事情去奮斗,要么你被生活所迫去努力,本質(zhì)上沒有其他可能。90 后作為最新的職場(chǎng)一代,之所以這么廣為詬病,就是在于這兩種動(dòng)力從群體意義上被打小閹割掉了。
區(qū)塊引用可以嵌套(例如:引用內(nèi)的引用),只要根據(jù)層次加上不同數(shù)量的 > ,例如:
> 無邊落木蕭蕭下 不盡長(zhǎng)江滾滾來
> > 出自唐代詩(shī)人杜甫的《登高》
> > > 真是一首好詩(shī)啊
輸出顯示如下:
無邊落木蕭蕭下 不盡長(zhǎng)江滾滾來
出自唐代詩(shī)人杜甫的《登高》
真是一首好詩(shī)啊
引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語(yǔ)法,包括標(biāo)題、列表、代碼區(qū)塊等,例如:
> ## 這是一個(gè)標(biāo)題。
> 1. 這是第一行列表項(xiàng)。
> 2. 這是第二行列表項(xiàng)。
>
> 給出一些例子代碼:
>
> return shell_exec("echo $input | $markdown_script");
輸出顯示如下:
這是一個(gè)標(biāo)題。
- 這是第一行列表項(xiàng)。
- 這是第二行列表項(xiàng)。
給出一些例子代碼:
return shell_exec("echo $input | $markdown_script");
3、列表
Markdown 支持有序列表和無序列表。
無序列表使用 * 、 + 或是 - 作為列表標(biāo)記:
* Red
* Green
* Blue
+ Red
+ Green
+ Blue
- Red
- Green
- Blue
輸出顯示如下:
- Red
- Green
- Blue
- Red
- Green
- Blue
- Red
- Green
- Blue
有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn):
- Bird
- McHale
- Parish
4、代碼區(qū)塊
要在 Markdown 中建立代碼區(qū)塊很簡(jiǎn)單,只要簡(jiǎn)單地縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符就可以,例如,下面的輸入:
static Singleton *single = nil;
+ (id)shareInstance {
static dispatch_once_t onceToken;
dispatch_once(&onceToken,^{
single = [[Singleton alloc] init];
});
return single;
}
注:上面的代碼塊從Xcode復(fù)制粘貼過來后可能會(huì)遇到縮進(jìn)的問題,因?yàn)槊啃械囊浑A縮進(jìn)(4 個(gè)空格或是 1 個(gè)制表符),都會(huì)被自動(dòng)移除。
我的解決辦法是:在 Xcode 中選中一段要復(fù)制的代碼,選中后使用command+]組合鍵讓代碼整體縮進(jìn) 1 個(gè)制表符后,再進(jìn)行整體復(fù)制,這樣就可以抵消被自動(dòng)移除的一階縮進(jìn),讓你在Xcode中漂亮的排版原封不動(dòng)的展示在代碼區(qū)塊中。
5、分隔線
你可以在一行中用三個(gè)以上的星號(hào)、減號(hào)、底線來建立一個(gè)分隔線,行內(nèi)不能有其他東西。你也可以在星號(hào)或是減號(hào)中間插入空格。下面每種寫法都可以建立分隔線,例如:
1
* * *
2
***
3
*****
4
- - -
5
---------------------------------------
輸出顯示如下:
1
2
3
4
5
6、鏈接和圖片
鏈接文字用 [方括號(hào)] 來標(biāo)記。插入鏈接只需要使用[顯示文本](鏈接地址)這樣的語(yǔ)法即可,例如:
歡迎來到 [簡(jiǎn)書](http://www.itdecent.cn/ "簡(jiǎn)書首頁(yè)")
[這里](http://example.net/) 有你喜歡的文章
輸出顯示如下:
插入網(wǎng)絡(luò)圖片:

輸出顯示如下:

上傳本地圖片:
如果需要上傳本地圖片,直接將圖片拖動(dòng)到編輯區(qū)域即可。
輸出顯示如下:

7、強(qiáng)調(diào)
用一個(gè) * 或 _ 包圍的字詞,會(huì)被顯示為斜體,
用兩個(gè) ** 或 _ _ 包起來的話,則會(huì)被顯示為粗體,例如:
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
輸出顯示如下:
single asterisks
single underscores
double asterisks
double underscores
注意:如果你的 * 和_兩邊都有空白的話,它們就只會(huì)被當(dāng)成普通的符號(hào)。
8、小段代碼、關(guān)鍵字
如果要標(biāo)記一小段行內(nèi)代碼或者關(guān)鍵字,你可以用反引號(hào)(\xxx`)`把它包起來,例如:
Use the `printf()` function.
輸出顯示如下:
Use the
printf()function.
9、反斜杠
Markdown 可以利用反斜杠來插入一些在語(yǔ)法中有其它意義的符號(hào),例如:如果你想要用星號(hào)加在文字旁邊的方式來做出強(qiáng)調(diào)效果,你可以在星號(hào)的前面加上反斜杠,例如:
\*Hello world\*
輸出顯示如下:
*Hello world*
如果不加反斜杠,則輸出顯示為斜體:
Hello world
10、表格
相關(guān)代碼:
name | height | weight
------ |--------- |---------
Tom | 175 | 65kg
Lily | 165 | 55kg
顯示如下:
| name | height | weight |
|---|---|---|
| Tom | 175 | 65kg |
| Lily | 165 | 55kg |
用:來表示對(duì)齊格式,加入對(duì)齊格式:
| name | height | weight|
|------ |:--------:|-------:|
| Tom | 175 | 65kg |
| Lily | 165 | 55kg |
加入對(duì)齊格式后,顯示如下:
| name | height | weight |
|---|---|---|
| Tom | 175 | 65kg |
| Lily | 165 | 55kg |