Markdown 簡(jiǎn)明語(yǔ)法

Markdown是一種輕量級(jí)的標(biāo)記語(yǔ)言,語(yǔ)法簡(jiǎn)單,可以排出簡(jiǎn)潔的表現(xiàn)界面。

  • 支持表格、代碼塊、LaTeX數(shù)學(xué)公式、目錄
  • 可以很方便的插入到 Gmail、Evernote
  • 很容易轉(zhuǎn)為 HTML 、PDF 文件
  • 可以自定義 css 文件,寫(xiě)出更直觀優(yōu)雅的筆記

注:按照Markdown標(biāo)準(zhǔn)語(yǔ)法描述,如果你的 Markdown 文本未能正確顯示,很可能是在標(biāo)記符號(hào)和文本間忘了保留一個(gè)字符的空格

一、標(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)題
六級(jí)標(biāo)題

二、列表

在 Markdown 中,只需要在文字前面加上+就可以轉(zhuǎn)換為列表,也可以用*-

+ 文本
  • 文本

在文字前面加上 1. 2. 3. 這樣的數(shù)字.空格可以生成序列表:

1. 文本1
2. 文本2
3. 文本3
  1. 文本1
  2. 文本2
  3. 文本3

三、鏈接和圖片

在 Markdown 中,鏈接用 [顯示文本](鏈接地址)的語(yǔ)法描述,例如:

[簡(jiǎn)書(shū)](http://jianshu.io)

可以用類似的語(yǔ)法描述圖片(前面多了一個(gè) ** !** ):

![](http://ww4.sinaimg.cn/bmiddle/aa397b7fjw1dzplsgpdw5j.jpg)

四、引用

> 我是被引用的內(nèi)容 =w=

我是被引用的內(nèi)容 =w=

五、加粗和斜體,刪除線

**兩個(gè)連續(xù)星號(hào)包圍一段文本,就把這段加粗啦**
*兩個(gè)單獨(dú)星號(hào)包圍一段文本,就讓文本傾斜咯*
_或者用下劃線來(lái)傾斜_
~~刪除線~~

** 兩個(gè)星號(hào)包圍一段文本,就把這段加粗啦 **
兩個(gè)單獨(dú)星號(hào)包圍一段文本,就讓文本傾斜咯
或者用下劃線來(lái)傾斜
刪除線
這里需要注意,*也被用于描述列表,為區(qū)別開(kāi),傾斜中的 * 和文本間不能留有空格。

六、表格

dog | bird | cat 
----|:----:|----:
foo | foo | foo
bar | bar | bar
baz | baz | baz

繪制表格 需要在前后均保留一行空白。由-|-|- 的結(jié)構(gòu)分割表頭和表身,請(qǐng)注意上述代碼中的:,控制了單列表格的對(duì)齊方向。(也可以用 | - | - | - | 的結(jié)構(gòu),顯得更加整潔)

dog bird cat
foo foo foo
bar bar bar
baz baz baz

七、分頁(yè)線和換行

---

三個(gè)以上的 -可以描繪一根分頁(yè)線 (注意前后要空行)


不分段換行:行末加兩個(gè)空格,直接回車
分段換行:兩個(gè)或多個(gè)回車(用空行來(lái)?yè)Q行)

八、代碼塊

行內(nèi)代碼用 `int sum = b + c`

這里用兩個(gè)`將 int sum = b+c描述為一段將背景標(biāo)紅的行內(nèi)代碼。
行內(nèi)代碼用 ` int sum = b + c `
行內(nèi)代碼用 int sum = b + c 又被上下的 ``` 標(biāo)記,變成一段灰色的代碼塊。
段前空一行,縮進(jìn)4個(gè)空格,然后書(shū)寫(xiě)代碼,也可以自動(dòng)轉(zhuǎn)為代碼塊。
此外,還可以自定義 css 文件,以 ```ruby 的開(kāi)頭描述“這是一段 ruby 代碼”,不同的描述可以適配不同的高亮。( Raysonte代碼高亮示例


進(jìn)階內(nèi)容

下述內(nèi)容并不經(jīng)常用到,可以直接拉到頁(yè)尾,看看擴(kuò)展閱讀或是推薦應(yīng)用。

一、數(shù)學(xué)公式

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

這段描述了在行內(nèi)嵌入公式 \sum_{i=1}^n a_i=0

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

在兩邊再包圍一對(duì) $,可以嵌入一個(gè)數(shù)學(xué)公式塊。

簡(jiǎn)書(shū)并不支持?jǐn)?shù)學(xué)公式, Raysnote數(shù)學(xué)公式示例

二、HTML代碼

在 Markdown 文本中可以直接書(shū)寫(xiě) html 代碼,這需要應(yīng)用的支持(大部分應(yīng)用都支持這一點(diǎn),目前發(fā)現(xiàn)簡(jiǎn)書(shū)不支持)。區(qū)塊元素 —— 比如<div>,<table>,<pre>,<p>必須在前后加上空行與其它內(nèi)容區(qū)隔開(kāi),還要求它們的開(kāi)始標(biāo)簽與結(jié)尾標(biāo)簽不能用制表符或空格來(lái)縮進(jìn)。
請(qǐng)注意,在 HTML 區(qū)塊標(biāo)簽間的 Markdown 格式語(yǔ)法將不會(huì)被處理,在HTML區(qū)段標(biāo)簽間則是有效的。

三、列表內(nèi)的內(nèi)容

1. 列表項(xiàng)目可以包含多個(gè)段落,每個(gè)項(xiàng)目下的段落必須縮進(jìn)4個(gè)空格或是1個(gè)制表符:

  1. This is the first line.
    This is the second line.
  1. This is the third line.

2. 如果要在列表內(nèi)放入引用,用>搭配縮進(jìn):

  • A list item with a blockquote:

    This is a blockquote

3. 要在列表內(nèi)放代碼塊,該區(qū)塊就要縮進(jìn)兩次:

  • A list
    print "Hello world!"

4. 1986. What a great season. 開(kāi)頭屬于 數(shù)字 . 空格,會(huì)被翻譯為列表:

  1. What a great season.

和 HTML中一樣,可以在符號(hào)前加上\來(lái)轉(zhuǎn)義

1986\. What a great season.

1986. What a great season.

5. 通過(guò)空格縮進(jìn)來(lái)生成多層列表

通過(guò)空格縮進(jìn)來(lái)生成多層列表

  • list
  • list1.1
    • list
      1. 列表1
      2. 列表2

推薦應(yīng)用

||
---- |:----|:----
Cmd Markdown|據(jù)說(shuō)是中文界最好的在線 Mark編輯器
簡(jiǎn)書(shū)|簡(jiǎn)書(shū)如何切換到 Markdown 編輯器
Raysnote|優(yōu)雅美觀好用的在線筆記,暫未提供導(dǎo)出功能
Markdown Here|瀏覽器插件,可以轉(zhuǎn)換網(wǎng)頁(yè)端郵件、Evernote內(nèi)容
馬克飛象|可以和印象筆記同步,¥78/年
MaHua|有導(dǎo)入導(dǎo)出的在線編輯器,非常漂亮

擴(kuò)展閱讀:
Markdown寫(xiě)作淺談
Markdown中文語(yǔ)法手冊(cè)

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

推薦閱讀更多精彩內(nèi)容