Markdown 語(yǔ)法(一邊寫一邊學(xué))

接觸簡(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)題。

  1. 這是第一行列表項(xiàng)。
  2. 這是第二行列表項(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):

  1. Bird
  2. McHale
  3. 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/) 有你喜歡的文章

輸出顯示如下:

歡迎來到 簡(jiǎn)書
這里 有你喜歡的文章

插入網(wǎng)絡(luò)圖片:

![網(wǎng)絡(luò)圖片:Markdown](http://upload-images.jianshu.io/upload_images/629934-74052f8714dc122c.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

輸出顯示如下:


網(wǎng)絡(luò)圖片:Markdown

上傳本地圖片:

如果需要上傳本地圖片,直接將圖片拖動(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
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容