1. 程式人生 > >5.markdown入門常用語法

5.markdown入門常用語法

height gin 出發 thead 輸入文本 分享 post 說明 預覽

原文地址:https://www.jianshu.com/p/q81RER/

「簡書」作為一款「寫作軟件」在誕生之初就支持了 Markdown,Markdown 是一種「電子郵件」風格的「標記語言」,我們強烈推薦所有寫作者學習和掌握該語言。為什麽?可以參考:

  • 『為什麽作家應該用 Markdown 保存自己的文稿』。
  • 『Markdown寫作淺談』

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

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

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

為了使您更好地學習,我們建議您登錄[「簡書」](http://www. jianshu.com),將您的編輯器切換至 Markdown 編輯器,新建一篇空白筆記,然後點擊右上角的預覽模式:

技術分享圖片

此時,您的界面應當如下圖所示,左側為編輯區域,右側為預覽區域,您在左側輸入 Markdown 語法的文本,右側會立即幫您呈現最終結果,好了,讓我們開始學習吧~

技術分享圖片

標題

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

而在 Markdown 中,你只需要在文本前面加上 # 即可,同理、你還可以增加二級標題、三級標題、四級標題、五級標題和六級標題,總共六級,只需要增加 # 即可,標題字號相應降低。例如:

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

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

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

技術分享圖片 一級標題至六級標題

列表

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

- 文本1
- 文本2
- 文本3

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

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

註:-1.和文本之間要保留一個字符的空格。

列表案例截圖如下:

技術分享圖片

<h2 id="picture"> 鏈接和圖片</h2>

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

[簡書](http://www.jianshu.com)

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

![](http://upload-images.jianshu.io/upload_images/259-0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

註:插入圖片的語法和鏈接的語法很像,只是前面多了一個

插入鏈接和圖片的案例截圖:

技術分享圖片

引用

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

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

註:> 和文本之間要保留一個字符的空格。

最終顯示的就是:

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

引用的案例截圖:

技術分享圖片

粗體和斜體

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

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

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

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

粗體和斜體的案例截圖:

技術分享圖片

代碼引用

需要引用代碼時,如果引用的語句只有一段,不分行,可以用 ` 將語句包起來。
如果引用的語句為多行,可以將```置於這段代碼的首行和末行。
代碼引用的案例截圖:

技術分享圖片

表格

相關代碼:

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

顯示效果:

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

<p></p>
相關代碼:

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

顯示效果:

dogbirdcat
foo foo foo
bar bar bar
baz baz baz

<p></p>

顯示鏈接中帶括號的圖片

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

代碼如下:

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

結語

以上幾種格式是比較常用的格式,所以我們針對這些語法做了比較詳細的說明。除這些之外,Markdown 還有其他語法,如想了解和學習更多,可以參考這篇『Markdown 語法說明』。

強烈建議您現在就立馬用 Markdown 寫一篇文章吧,體會一下 Markdown 的優雅之處!

最後,希望我們的指南可以幫助到您,也希望「簡書」能夠成為您書寫 Markdown 的最佳選擇。



作者:簡書
鏈接:https://www.jianshu.com/p/q81RER/
來源:簡書
著作權歸作者所有。商業轉載請聯系作者獲得授權,非商業轉載請註明出處。

5.markdown入門常用語法