簡(jiǎn)書Markdown新手教程


(小白入手必讀)

喜歡簡(jiǎn)書的朋友,每天看著別人寫的文章,自己也總會(huì)有想去寫一些東西的沖動(dòng),可是面對(duì)簡(jiǎn)書的文本編輯格式,不少人會(huì)望而卻步。

我是從三年前就一直關(guān)注簡(jiǎn)書的,也算是老用戶了,今天終于決定提起筆開(kāi)始寫作之路。然而要想用簡(jiǎn)書進(jìn)行創(chuàng)作,就不能不學(xué)習(xí)Markdown語(yǔ)法,我這兩天在網(wǎng)上查找了一些Markdown語(yǔ)法教程,但并不能解決我書寫過(guò)程在遇到的所有問(wèn)題。

所以今天我寫下這篇文章,用來(lái)給像我一樣的小白以指導(dǎo)(本文創(chuàng)作過(guò)程中用到的參考同樣會(huì)附上,以方便大家更快地學(xué)習(xí))。


先簡(jiǎn)單介紹一下Markdown語(yǔ)言

Markdown是一種可以使用普通文本編輯器編寫的標(biāo)記語(yǔ)言,通過(guò)簡(jiǎn)單的標(biāo)記語(yǔ)法,它可以使普通文本內(nèi)容具有一定的格式。

由于初始的Markdown語(yǔ)言并不完善,所以Markdown有一系列的衍生版本,用于擴(kuò)展Markdown的功能(如表格、腳注等)。

這些衍生的版本讓Markdown擁有了更多的功能,雖然在一些語(yǔ)法和渲染效果上有改動(dòng),但是語(yǔ)法基本上都是相互兼容的。今天我們要講述的簡(jiǎn)書編輯器也是衍生版本之一,只不過(guò)簡(jiǎn)書讓Markdown語(yǔ)言更加方便實(shí)用,這里不得不贊一下幕后的程序員們,O(∩_∩)O哈哈~

當(dāng)然啦,我們就只是想用這種工具來(lái)完成我們的寫作,所以很多功能都不是必須要知道的,這里我就只介紹一下寫作過(guò)程中會(huì)用到而且方便使用的集中語(yǔ)法。

好了,不贅述了,趕快進(jìn)入正文啦!


1.標(biāo)題


標(biāo)題是一篇文章必不可少的,也是寫作最先接觸到的,所以把標(biāo)題放在第一章節(jié)。

例如:
Markdown程序:

# 這是一級(jí)標(biāo)題
## 這是二級(jí)標(biāo)題
### 這是三級(jí)標(biāo)題
#### 這是四級(jí)標(biāo)題
##### 這是五級(jí)標(biāo)題

得到的渲染結(jié)果為:

這是一級(jí)標(biāo)題

這是二級(jí)標(biāo)題

這是三級(jí)標(biāo)題

這是四級(jí)標(biāo)題

這是五級(jí)標(biāo)題

由此例可以看出#符號(hào)的個(gè)數(shù)代表標(biāo)題的級(jí)數(shù),需要三級(jí)標(biāo)題就用三個(gè)#號(hào),需要五級(jí)標(biāo)題就用五個(gè)#號(hào),以此類推。

(注意!注意!注意?。?br> #號(hào)和標(biāo)題之間的空格可有可無(wú),不影響效果!

還有一種情況需要特別說(shuō)明:
為了對(duì)稱美觀,標(biāo)題后邊也可以加空格和#號(hào)。

例如:
Markdown語(yǔ)言:

# 這是一級(jí)標(biāo)題 #
## 這是二級(jí)標(biāo)題 ##
### 這是三級(jí)標(biāo)題 ###
### 這是三級(jí)標(biāo)題    ###
### 這是三級(jí)標(biāo)題 ######
### 這是三級(jí)標(biāo)題 ##########

得到的顯示為:

這是一級(jí)標(biāo)題

這是二級(jí)標(biāo)題

這是三級(jí)標(biāo)題

這是三級(jí)標(biāo)題

這是三級(jí)標(biāo)題

這是三級(jí)標(biāo)題

標(biāo)題后空格、#號(hào)的添加與否,以及空格和#號(hào)個(gè)數(shù)的多少,均不會(huì)影響渲染效果。


2.字體


Markdown語(yǔ)言中的字體的樣式主要有正常、傾斜、加粗、加粗傾斜、刪除線五種字體樣式。
傾斜字體需要在兩邊各使用一個(gè)*或者_;
加粗字體需要在兩邊各使用兩個(gè)個(gè)*;
傾斜加粗字體需要在兩邊各使用三個(gè)*
刪除線字體需要在兩邊各使用兩個(gè)~。

例如:
Markdown語(yǔ)言:

This is Normal Type.
*This is Italic Type.*
_This is Italic Type._
**This is Bold Type.**
***This is Italic & Bold Type.***
~~This is Delete Type.~~

得到的顯示為:
This is Normal Type.
This is Italic Type.
This is Italic Type.
This is Bold Type.
This is Italic & Bold Type.
This is Delete Type.


3.列表


Markdown支持無(wú)序列表有序列表。


3.1無(wú)序列表和有序列表


3.1.1無(wú)序列表

無(wú)序列表使用- + *進(jìn)行列表標(biāo)記。

例如:
Markdown語(yǔ)言:

- 生命誠(chéng)可貴,
+ 愛(ài)情價(jià)更高;
* 若為自由故,
- 兩者皆可拋!

得到的顯示為:

  • 生命誠(chéng)可貴,
  • 愛(ài)情價(jià)更高;
  • 若為自由故,
  • 兩者皆可拋!

注意:- + *三種符號(hào)是等同的。

3.1.2有序列表

例如:
Markdown語(yǔ)言:

1. 生命誠(chéng)可貴,
2. 愛(ài)情價(jià)更高;
3. 若為自由故,
4. 兩者皆可拋!

得到的顯示為:

  1. 生命誠(chéng)可貴,
  2. 愛(ài)情價(jià)更高;
  3. 若為自由故,
  4. 兩者皆可拋!

3.1.3有序列表中的無(wú)序列表

例如:
Markdown語(yǔ)言:

1. 生命誠(chéng)可貴,
2. 愛(ài)情價(jià)更高;
   - 生命誠(chéng)可貴,
   + 愛(ài)情價(jià)更高;
3. 若為自由故,
   * 若為自由故,
   - 兩者皆可拋!
4. 兩者皆可拋!

得到的顯示為:

  1. 生命誠(chéng)可貴,
  2. 愛(ài)情價(jià)更高;
    • 生命誠(chéng)可貴,
    • 愛(ài)情價(jià)更高;
  3. 若為自由故,
    • 若為自由故,
    • 兩者皆可拋!
  4. 兩者皆可拋!

3.1.4無(wú)序列表中的有序列表

例如:
Markdown語(yǔ)言:

- 生命誠(chéng)可貴,
+ 愛(ài)情價(jià)更高;
    1. 生命誠(chéng)可貴,
    1. 愛(ài)情價(jià)更高;
    1. 若為自由故,
    1. 兩者皆可拋!
* 若為自由故,
- 兩者皆可拋!

Markdown語(yǔ)言:

- 生命誠(chéng)可貴,
+ 愛(ài)情價(jià)更高;
    1. 生命誠(chéng)可貴,
    2. 愛(ài)情價(jià)更高;
    3. 若為自由故,
    4. 兩者皆可拋!
* 若為自由故,
- 兩者皆可拋!

最后得出的渲染效果相同,得到的顯示都是:

  • 生命誠(chéng)可貴,
  • 愛(ài)情價(jià)更高;
    1. 生命誠(chéng)可貴,
    2. 愛(ài)情價(jià)更高;
    3. 若為自由故,
    4. 兩者皆可拋!
  • 若為自由故,
  • 兩者皆可拋!

可以看出:在Markdown語(yǔ)言中,無(wú)序列表中的有序列表前的數(shù)字序號(hào)對(duì)列表的渲染效果是沒(méi)有影響的。

3.1.5有序列表中的有序列表

例如:
Markdown語(yǔ)言:

1. 生命誠(chéng)可貴,
2. 愛(ài)情價(jià)更高;
   1. 生命誠(chéng)可貴,
   2. 愛(ài)情價(jià)更高;
   3. 若為自由故,
   4. 兩者皆可拋!
3. 若為自由故,
4. 兩者皆可拋!

得到的顯示為:

  1. 生命誠(chéng)可貴,
  2. 愛(ài)情價(jià)更高;
    1. 生命誠(chéng)可貴,
    2. 愛(ài)情價(jià)更高;
    3. 若為自由故,
    4. 兩者皆可拋!
  3. 若為自由故,
  4. 兩者皆可拋!

3.1.6無(wú)序列表中的無(wú)序列表

接下來(lái)列舉兩個(gè)文章中常用到的兩種無(wú)序列表嵌套使用的實(shí)例子:

例如:
Markdown語(yǔ)言:

- 生命誠(chéng)可貴,
+ 愛(ài)情價(jià)更高;
* - 若為自由故,
- * 兩者皆可拋!

得到的顯示為:

  • 生命誠(chéng)可貴,
  • 愛(ài)情價(jià)更高;
    • 若為自由故,
    • 兩者皆可拋!

注意:
上一級(jí)和下一級(jí)的無(wú)序列表混合使用,可以使用在下一級(jí)的無(wú)序列表前添加三個(gè)空格鍵實(shí)現(xiàn)。

例如:
Markdown語(yǔ)言:

- 生命誠(chéng)可貴,
+ 愛(ài)情價(jià)更高;
   * 生命誠(chéng)可貴,
   - 愛(ài)情價(jià)更高;
      - 若為自由故,
      * 兩者皆可拋!
   - 若為自由故,
   * 兩者皆可拋!

得到的顯示為:

  • 生命誠(chéng)可貴,
  • 愛(ài)情價(jià)更高;
    • 生命誠(chéng)可貴,
    • 愛(ài)情價(jià)更高;
      • 若為自由故,
      • 兩者皆可拋!
    • 若為自由故,
    • 兩者皆可拋!

3.2列表縮進(jìn)


Markdown語(yǔ)法中支持列表項(xiàng)目縮進(jìn),只用在第一行內(nèi)容前使用列表符。

例如:
Markdown語(yǔ)言:

- 莫聽(tīng)穿林打葉聲,
何妨吟嘯且徐行。
竹杖芒鞋輕勝馬,

+ 誰(shuí)怕?
一蓑煙雨任平生。

得到的顯示為:

  • 莫聽(tīng)穿林打葉聲,
    何妨吟嘯且徐行。
    竹杖芒鞋輕勝馬,
  • 誰(shuí)怕?
    一蓑煙雨任平生

3.3包含段落的列表縮進(jìn)


當(dāng)列表項(xiàng)目中包含多個(gè)段落時(shí),每個(gè)段落之前都必須縮進(jìn)4個(gè)空格符(一次縮進(jìn))。

例如:
Markdown語(yǔ)言:

- 莫聽(tīng)穿林打葉聲,
何妨吟嘯且徐行。
竹杖芒鞋輕勝馬,
一蓑煙雨任平生。

    莫聽(tīng)穿林打葉聲,
何妨吟嘯且徐行。
竹杖芒鞋輕勝馬,
一蓑煙雨任平生

得到的顯示為:

  • 莫聽(tīng)穿林打葉聲,
    何妨吟嘯且徐行。
    竹杖芒鞋輕勝馬,
    一蓑煙雨任平生。

    莫聽(tīng)穿林打葉聲,
    何妨吟嘯且徐行。
    竹杖芒鞋輕勝馬,
    一蓑煙雨任平生


3.4包含引用的列表


如果要在列表中進(jìn)行引用,需要使用>符號(hào)進(jìn)行實(shí)現(xiàn):

例如:
Markdown語(yǔ)言:

- 莫聽(tīng)穿林打葉聲,
何妨吟嘯且徐行。
竹杖芒鞋輕勝馬,
一蓑煙雨任平生。
> 莫聽(tīng)穿林打葉聲,
何妨吟嘯且徐行。
竹杖芒鞋輕勝馬,
一蓑煙雨任平生

得到的顯示為:

  • 莫聽(tīng)穿林打葉聲,
    何妨吟嘯且徐行。
    竹杖芒鞋輕勝馬,
    一蓑煙雨任平生。

莫聽(tīng)穿林打葉聲,
何妨吟嘯且徐行。

竹杖芒鞋輕勝馬,
一蓑煙雨任平生


3.5一個(gè)特殊情況


這里講一下\符號(hào)的特殊使用(避免在行首出現(xiàn)'數(shù)字-句點(diǎn)-空白'的情況,需要在數(shù)字之后加上\符號(hào))。

例如:
Markdown語(yǔ)言:

2008. Nowadays, people of all strata begin to ...

2008\. Nowadays, people of all strata begin to ...

得到的顯示為:

  1. Nowadays, people of all strata begin to ...

2008. Nowadays, people of all strata begin to ...


4.引用和嵌套


4.1引用


引用是指在說(shuō)話或?qū)懽髦幸矛F(xiàn)成的話,如詩(shī)句、格言、成語(yǔ)等,以表達(dá)自己思想感情的修辭方法。

在書本的行文中用引號(hào)(“ ”和' ')來(lái)表示引用,相應(yīng)的,在Markdown語(yǔ)言中也給了特殊的語(yǔ)言以及渲染效果來(lái)表示引用。

例如:
Markdown語(yǔ)言:

> 我愿意是急流,
山里的小河,
在崎嶇的路上,
巖石上經(jīng)過(guò)……

得到的顯示為:

我愿意是急流,
山里的小河,
在崎嶇的路上,
巖石上經(jīng)過(guò)……

在這里,Markdown語(yǔ)言允許我們偷懶,僅需要在第一行中使用>符號(hào)就可以一直引用,而不用在每一行引用的內(nèi)容前都添加>符號(hào),大大方便了我們的使用。同理,>符號(hào)后的空格可有可無(wú)。

那么,如果想結(jié)束引用,該怎么辦呢?
答案:可以使用空行來(lái)結(jié)束內(nèi)容的引用。

例如:
Markdown語(yǔ)言:

> 我愿意是急流,
山里的小河,

在崎嶇的路上,
巖石上經(jīng)過(guò)……

得到的顯示為:

我愿意是急流,
山里的小河,

在崎嶇的路上,
巖石上經(jīng)過(guò)……


4.2嵌套{#index}


嵌套,指在已有的表格、圖像或圖層中再加進(jìn)去一個(gè)或多個(gè)表格、圖像或圖層的方法,簡(jiǎn)單可理解為鑲嵌、套用。在Markdown語(yǔ)言中,嵌套表示在引用的內(nèi)容中引用另外的內(nèi)容。

例如:
Markdown語(yǔ)言:

> 我愿意是急流,
山里的小河,
> > 在崎嶇的路上,
巖石上經(jīng)過(guò)……
> > > 只要我的愛(ài)人
是一條小魚,
> > > > > > > 在我的浪花中
快樂(lè)地游來(lái)游去

得到的顯示為:

我愿意是急流,
山里的小河,

在崎嶇的路上,

巖石上經(jīng)過(guò)……

只要我的愛(ài)人
是一條小魚,

在我的浪花中
快樂(lè)地游來(lái)游去

注意:
如果想結(jié)束當(dāng)前引用返回到上一級(jí)的引用,可以先使用空行來(lái)結(jié)束當(dāng)前引用,再使用與想返回一級(jí)相同數(shù)量的>符號(hào)來(lái)實(shí)現(xiàn)。

例如:
Markdown語(yǔ)言:

> 我愿意是急流,
山里的小河,
> > 在崎嶇的路上,
巖石上經(jīng)過(guò)……
> > > 只要我的愛(ài)人
是一條小魚,
> > > > 在我的浪花中
快樂(lè)地游來(lái)游去

> > 在我的浪花中
快樂(lè)地游來(lái)游去

得到的顯示為:

我愿意是急流,
山里的小河,

在崎嶇的路上,
巖石上經(jīng)過(guò)……

只要我的愛(ài)人
是一條小魚,

在我的浪花中
快樂(lè)地游來(lái)游去

在我的浪花中
快樂(lè)地游來(lái)游去


5.超鏈接和錨點(diǎn)


Markdown語(yǔ)法提供了三種超鏈接形式:行內(nèi)式、參考式和自動(dòng)鏈接。


5.1行內(nèi)式超鏈接


行內(nèi)式超鏈接形式是最常用的,語(yǔ)法如下(鏈接標(biāo)題一項(xiàng)可有可無(wú)):

[鏈接文字](鏈接地址 "鏈接標(biāo)題")

鏈接地址和鏈接標(biāo)題之間有一個(gè)空格。

例如:
Markdown語(yǔ)言:

歡迎訪問(wèn)[微博](https://weibo.com/);
快速進(jìn)入[簡(jiǎn)書](http://m.itdecent.cn/ "簡(jiǎn)書"),開(kāi)啟你的創(chuàng)作;
歡迎來(lái)到[知乎](https://www.zhihu.com/ "知乎"),發(fā)現(xiàn)更大的世界。

得到的顯示為:
歡迎訪問(wèn)微博
快速進(jìn)入簡(jiǎn)書,開(kāi)啟你的創(chuàng)作;
歡迎來(lái)到知乎,發(fā)現(xiàn)更大的世界。


5.2參考式超鏈接


參考式超鏈接分為兩種,一種是鏈接文字和鏈接標(biāo)記不同,一種是鏈接文字本身作為鏈接標(biāo)記。

鏈接文字和鏈接標(biāo)記不同時(shí),語(yǔ)法分為兩部分,Markdown語(yǔ)法如下:
[鏈接文字][鏈接標(biāo)記](méi)
[鏈接標(biāo)記](méi):鏈接地址 "鏈接標(biāo)題"

鏈接文字本身作為鏈接標(biāo)記時(shí),語(yǔ)法也分為兩部分,如下:
[鏈接文字][]
[鏈接文字]:鏈接地址

例如:
Markdown語(yǔ)言:

每天我必須會(huì)訪問(wèn)的三個(gè)網(wǎng)站[簡(jiǎn)書][1]、[微博][2]、[知乎][3],
除了這三個(gè)必須訪問(wèn)的網(wǎng)站,還會(huì)訪問(wèn)[喜馬拉雅FM][]、[書法之家][]等。

[1]:http://m.itdecent.cn/
[2]:https://www.weibo.com/ "微博"
[3]:https://www.zhihu.com/ "知乎"
[喜馬拉雅FM]:https://www.ximalaya.com/
[書法之家]:http://www.sfzj123.com/m

得到的顯示為:

每天我必須會(huì)訪問(wèn)的三個(gè)網(wǎng)站簡(jiǎn)書微博、知乎,
除了這三個(gè)必須訪問(wèn)的網(wǎng)站,還會(huì)訪問(wèn)喜馬拉雅FM、書法之家等。

注意:和所有編程語(yǔ)言一樣,Markdown語(yǔ)法中所有的字母和符號(hào)都必須是半角符號(hào)。


5.3自動(dòng)鏈接


自動(dòng)鏈接常用來(lái)處理網(wǎng)址和郵箱地址等,只需要用<>將網(wǎng)址或者郵箱包括起來(lái)就可以了。

例如:
Markdown語(yǔ)言:

<http://m.itdecent.cn/>
<https://www.weibo.com/>
<gyf_seu@163.com>

得到的顯示為:

http://m.itdecent.cn/
https://www.weibo.com/
gyf_seu@163.com


6.分割線


你可以在一行中使用三個(gè)以上的*、-_來(lái)建立一個(gè)分割線,行內(nèi)不能有其他字符。也可以在這三種符號(hào)之間加入空格,不影響渲染效果。

例如:
Markdown語(yǔ)言:


---

- - - 

--------

***

* * *

___

_ _ _ _ _

得到的顯示為:








這些不同的語(yǔ)法得到的渲染效果都是相同的。


7.圖像


簡(jiǎn)書Markdown圖片的創(chuàng)建方式與超鏈接相似,最常用的方法就是行內(nèi)式。

行內(nèi)式的Markdown語(yǔ)法如下:
[圖片上傳失敗...(image-a73492-1543568295086)]

例如:
行內(nèi)式Markdown語(yǔ)言:

![星空.jpg](https://upload-images.jianshu.io/upload_images/1401287-46f6c1b0742b2059.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240  "星空 梵高")

得到的顯示為:

星空.jpg


8.表格


表格語(yǔ)法說(shuō)明:

  • 1. 第一行為表頭,第二行為分割行(用來(lái)分開(kāi)表頭和表格正文行),第三行及以后為正文行;
  • 2. 列與列之間使用符號(hào)|隔開(kāi);
  • 3. 第二行可以為不同的列指定對(duì)齊方向。

例如:
參考式Markdown語(yǔ)言:

|姓名|性別|年齡| 
|-  | :-:| -----| 
|小明|男|5| 
|大黃|男|6| 
|小紅|女|4| 
和:
|項(xiàng)目|價(jià)格|數(shù)量|
|---|:--:|--:|
|計(jì)算機(jī)|\$1600|5|
|手機(jī)|\$12|12|
|管線|\$1|234|

得到的顯示為:

姓名 性別 年齡 出生地
小明 5 北京
大黃 6 上海
小紅 4 深圳

和:

項(xiàng)目 價(jià)格 數(shù)量
計(jì)算機(jī) $1600 5
手機(jī) $12 12
管線 $1 234

需要值得說(shuō)明的是:

  • 1. 兩個(gè)符號(hào)|之間,除了需要顯示的內(nèi)容外,可以有空格,空格不影響渲染效果;
  • 2. 第二行使用:來(lái)指定列的對(duì)齊方向,默認(rèn)居左顯示。

9.待辦事宜Todo列表


Markdown語(yǔ)言中可以使用帶有[ ][x](未完成或已完成)的列表語(yǔ)法撰寫一個(gè)待辦事宜列表,并且支持子列表嵌套以及混用Markdown語(yǔ)法.

例如:
Markdown語(yǔ)言:


- [ ] **今天的工作**
    - [ ] 做office
    - [ ] 畫圖
    - [x] 辦簽證 
    - [x] 辦理護(hù)照
        - [x] 拍照
        - [x] 公證  

得到的顯示為:

  • [ ] 今天的工作
    • [ ] 做office
    • [ ] 畫圖
    • [x] 辦簽證
    • [x] 辦理護(hù)照
      • [x] 拍照
      • [x] 公證

注意:語(yǔ)法中可以使用4個(gè)空格(一次縮進(jìn))來(lái)表示上下級(jí)從屬關(guān)系。


10.注腳


在需要添加注腳的文字后邊使用[^keyword]來(lái)添加注腳。

語(yǔ)法如下:
[^keyword1]
[^keyword2]
[^keyword3]

[^keyword1]:注腳釋義。

[^keyword2]:注腳釋義。

[^keyword3]:注腳釋義。

例如:
Markdown語(yǔ)言:


這是一個(gè)注腳[^footnote]的樣例。
這是第二個(gè)注腳[^footnote2]的樣例。
使用Markdown[^2]可以提高書寫效率。

[^footnote]:這個(gè)注腳只是個(gè)例子;

[^footnote2]:這個(gè)注腳也是個(gè)例子;

[^2]:這個(gè)注腳還是個(gè)例子;  

得到的顯示為:

這是一個(gè)注腳[1]的樣例。
這是第二個(gè)注腳[2]的樣例。
使用Markdown[3]可以提高書寫效率。

注意:

  1. 注腳前必須有對(duì)應(yīng)的注腳名字(keyword);
  2. 兩個(gè)注腳之間必須要空一行,否則會(huì)失效;
  3. 所有的注腳在渲染結(jié)果中都會(huì)被自動(dòng)移到文末。

11.LaTeX公式


11.1行內(nèi)公式

在Markdown語(yǔ)言中,用$來(lái)表示行內(nèi)公式,例如質(zhì)能守恒方程可以用一個(gè)很簡(jiǎn)潔的方程式來(lái)表達(dá)。

例如:
Markdown語(yǔ)言:

$E=mc^2$   

得到的顯示為:

E=mc^2

11.2整行公式

Markdown語(yǔ)言中用$$表示整行公式.

例如:
Markdown語(yǔ)言:

$$\sum_{i=1}^n a_i=0$$

$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$

$$\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}$$  

得到的顯示為:
\sum_{i=1}^n a_i=0

f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2

\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}

訪問(wèn) MathJax 參考更多使用方法。


12.代碼


Markdown支持四十一種編程語(yǔ)言的語(yǔ)法高亮的顯示,行號(hào)顯示。

12.1單行代碼

單行代碼的顯示,需要借助 ` 符號(hào)來(lái)實(shí)現(xiàn),在單行代碼的兩段分別使用一個(gè)。

例如:
Markdown語(yǔ)言:

`print 'I'm a good boy.`

得到的顯示為:

print 'I'm a good boy.

12.2代碼塊

代碼塊的顯示需要借助三個(gè) ` 符號(hào)實(shí)現(xiàn),即在代碼塊的前后分別使用三個(gè)。

非代碼示例:

$ sudo apt-get install vim-gnome

Python 示例:

@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None
class SomeClass:
    pass
>>> message = '''interpreter
... prompt'''

JavaScript 示例:

/**
* nth element in the fibonacci series.
* @param n >= 0
* @return the nth element, >= 0.
*/
function fib(n) {
  var a = 1, b = 1;
  var tmp;
  while (--n >= 0) {
    tmp = a;
    a += b;
    b = tmp;
  }
  return a;
}
document.write(fib(10));

由于簡(jiǎn)書是Markdown原生編輯器衍生出來(lái)的一個(gè)版本,所以簡(jiǎn)書編輯器對(duì)語(yǔ)法進(jìn)行了適當(dāng)?shù)男薷模沟煤?jiǎn)書編輯器更利于文章創(chuàng)作。

很多Markdown語(yǔ)法在簡(jiǎn)書編輯器中渲染不了,所以本文中只列舉了最常用最方便的語(yǔ)法。

時(shí)間倉(cāng)促,多有不足,歡迎大家指正!


  1. 這個(gè)注腳只是個(gè)例子; ?

  2. 這個(gè)注腳也是個(gè)例子; ?

  3. 這個(gè)注腳還是個(gè)例子; ?

最后編輯于
?著作權(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)容

  • 什么是Markdown? Markdown是一種輕量級(jí)標(biāo)記語(yǔ)言。它允許人們“使用易讀易寫的純文本格式編寫文檔,然后...
    itbsl閱讀 5,126評(píng)論 1 17
  • 為什么學(xué)習(xí)Markdown 自從搭建了 Hexo 博客之后,發(fā)現(xiàn)還有 Markdown 這種寫文章的方法,想到以后...
    lifeColder閱讀 20,481評(píng)論 10 216
  • Markdown概述 宗旨 Markdown 的目標(biāo)是實(shí)現(xiàn)「易讀易寫」。Markdown 的特點(diǎn)就是,讓寫作變得更...
    心疼你萌萌噠閱讀 10,317評(píng)論 1 24
  • 為什么要用Markdown Markdown十分的簡(jiǎn)潔,跨平臺(tái)性更是不用說(shuō),一個(gè)VIM或記事本就可以完成的編寫,我...
    BigJelly閱讀 403評(píng)論 0 1
  • NOTE: This is Simplelified Chinese Edition Document of Ma...
    唯有口袋里的錢能給我安全感閱讀 821評(píng)論 0 6

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