1. 程式人生 > >markdown新手指南(語法簡介)

markdown新手指南(語法簡介)

在此,我們總結 Markdown 的優點如下:

  • 純文字,所以相容性極強,可以用所有文字編輯器開啟。
  • 讓你專注於文字而不是排版。
  • 格式轉換方便,Markdown 的文字你可以輕鬆轉換為 html、電子書等。
  • Markdown 的標記語法有極好的可讀性。

當然,我們既然如此推崇 Markdown ,也必定會教會你使用 Markdown ,這也是本文的目的所在。不過,雖然 Markdown 的語法已經足夠簡單,但是現有的 Markdown 語法說明更多的是寫給 web 從業者看的,對於很多寫作者來說,學習起來效率很低,現在,我們特地為寫作者量身定做本指南,從寫作者的實際需求出發,介紹寫作者真正實用的常用格式,深入淺出、圖文並茂地讓您迅速掌握 Markdown 語法。

為了使您更好地學習,我們建議您登入「簡書」,將您的編輯器切換至 Markdown 編輯器,新建一篇空白筆記,然後點選右上角的預覽模式,此時,您的介面應當如下圖所示,左側為編輯區域,右側為預覽區域,您在左側輸入 Markdown 語法的文字,右側會立即幫您呈現最終結果,好了,讓我們開始學習吧~

簡書的預覽模式可以幫助你更快掌握 Markdown:

標題

這是最為常用的格式,在平時常用的的文字編輯器中大多是這樣實現的:輸入文字、選中文字、設定標題格式。

而在 Markdown 中,你只需要在文字前面加上 # 即可,同理、你還可以增加二級標題、三級標題、四級標題、五級標題和六級標題,總共六級,只需要增加#

即可,標題字號相應降低。例如:

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題

注:# 和「一級標題」之間建議保留一個字元的空格,這是最標準的 Markdown 寫法。

你可以你的編輯器中嘗試輸入這六級標題,可以參考下方的截圖:
一級標題至六級標題

列表

列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 - 就可以了,例如:

- 文字1
- 文字2
- 文字3

如果你希望有序列表,也可以在文字前面加上 1. 2. 3. 就可以了,例如:

1. 文字1
2. 文字2
3. 文字3

注:-1.和文字之間要保留一個字元的空格。

列表案例截圖如下:


連結和圖片

在 Markdown 中,插入連結不需要其他按鈕,你只需要使用 [顯示文字](連結地址) 這樣的語法即可,例如:

[簡書](http://jianshu.io)

在 Markdown 中,插入圖片不需要其他按鈕,你只需要使用 ![](圖片連結地址) 這樣的語法即可,例如:

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

注:插入圖片的語法和連結的語法很像,只是前面多了一個

插入連結和圖片的案例截圖:

引用

在我們寫作的時候經常需要引用他人的文字,這個時候引用這個格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上 > 就好了,例如:

> 一盞燈, 一片昏黃; 一簡書, 一杯淡茶。 守著那一份淡定, 品讀屬於自己的寂寞。 保持淡定, 才能欣賞到最美麗的風景! 保持淡定, 人生從此不再寂寞。

注:> 和文字之間要保留一個字元的空格。

最終顯示的就是:

一盞燈, 一片昏黃; 一簡書, 一杯淡茶。 守著那一份淡定, 品讀屬於自己的寂寞。 保持淡定, 才能欣賞到最美麗的風景! 保持淡定, 人生從此不再寂寞。

引用的案例截圖:

粗體和斜體

Markdown 的粗體和斜體也非常簡單,用兩個 * 包含一段文字就是粗體的語法,用一個 * 包含一段文字就是斜體的語法。例如:

 *一盞燈*, 一片昏黃;**一簡書**, 一杯淡茶。 守著那一份淡定, 品讀屬於自己的寂寞。 保持淡定, 才能欣賞到最美麗的風景! 保持淡定, 人生從此不再寂寞。

最終顯示的就是下文,其中「一盞燈」是斜體,「一簡書」是粗體:

一盞燈, 一片昏黃;一簡書, 一杯淡茶。 守著那一份淡定, 品讀屬於自己的寂寞。 保持淡定, 才能欣賞到最美麗的風景! 保持淡定, 人生從此不再寂寞。

粗體和斜體的案例截圖:

表格

相關程式碼:

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

顯示效果:

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

相關程式碼:
dog | bird | cat
----|------|----
foo | foo  | foo
bar | bar  | bar
baz | baz  | baz

顯示效果:

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

顯示連結中帶括號的圖片

程式碼如下:

![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1

結語

以上幾種格式是比較常用的格式,所以我們針對這些語法做了比較詳細的說明。除這些之外,Ma



文/簡書(簡書作者)
原文連結:http://www.jianshu.com/p/q81RER
著作權歸作者所有,轉載請聯絡作者獲得授權,並標註“簡書作者”。