目的
對Markdown的語法進行最基礎簡單的介紹,能夠滿足在各個方面的基本使用。
說明
markdown語法目前有兩種,我會選擇一種我在實踐過程中認爲比較簡單的標記來進行簡單介紹。如果需要進行查閱,可以直接閱讀末尾總結
部分。
markdown也支持部分HTML,如果需要實現換行等需求也可以使用<br/>
等來完成。
不同的markdown語法識別器可能會對統一份markdown語法產生不同的解釋,屬於正常現象。
segmentfault的markdown解釋器就和我使用的MacDown產生了不同的結果,害得我調調整了好久囧~~
工具
本人是在Mac上進行工作與開發,因此推薦Mac上的軟件——MacDown進行開發,windows上的用戶可以自行挑選較爲合適的客戶端或者選擇跨平臺的線上編輯器。
語法簡介
段落
段落以#
號開頭,1個#
代表爲一級標題,以此類推,2~6個#
分別爲2~6級標題。其中#
後建議添加一個空格
。
列表
列表分爲有序列表和無序列表兩種。
有序列表
以數字
+.
+空格
爲開頭的語句,會被識別成爲一個有序列表。例如:
1.(空格)a 2.(空格)b 3.(空格)c
會被識別爲:
- a
- b
- c
無序列表
以-
+空格
爲開頭的語句,會被識別爲一個無序列表。例如:
-(空格)a -(空格)b -(空格)c
會被識別爲:
- a
- b
- c
鏈接
符合[名字]
+(網址)
格式的語句會被識別爲一個超鏈接,其中小括號中爲超鏈接顯示的名字,而中括號爲鏈接的網址。例如:
[百度](www.baidu.com)
會被識別爲:
圖片
符合!
+[]
+(圖片網址)
格式的語句會被識別爲一個圖片,其中小括號爲圖片的網址。例如:
![](http://www.taopic.com/uploads/allimg/120628/201776-12062Q4295216.jpg)
會被識別爲:
引用
符合>
+空格
格式的語句會被識別爲一個圖片,其中後面緊接的文字爲引用文字。例如:
(>)(空格)引用——去掉大於號左右的括號
會被識別爲:
引用
傾斜、加粗與分割線
傾斜與加粗的格式類似,都是*
+文字
+*
,*號中的文字爲傾斜或者加粗的文字。其中傾斜爲一個*
號,而加粗爲兩個*
號, 分割線爲***
。例如:
*傾斜* **加粗** ***
會被識別爲:
傾斜
加粗
表格
表格的格式比較複雜,我們先看一個例子:
|line1|line2|line3|line4| |:--|--:|:-:|---| |111|222|333|444| |111|222|333|444|
會被識別爲:
line1 | line2 | line3 | line4 |
---|---|---|---|
111 | 222 | 333 | 444 |
111 | 222 | 333 | 444 |
讓我們來看下具體的語法:
表頭以豎線間隔開頭,每個間隔內的文字都是列頭。:
表示當前列的對齊位置,在最左邊爲局左對齊,在最右邊爲居右對齊,如果兩邊各有一個,則表示居中對齊,如果沒有冒號,則不需要對齊。第二列每個豎線中至少有3個字符(可以多,不可以少,冒號最多存在兩個——居中對齊情況)來表示對齊的方式。
下面每個豎線內都是對應該列的內容,後面若干列如果爲空可以不需要寫豎線。
代碼
代碼有兩種方式,一種是行內方式,具體請看示例。
這是一個`測試` 這是一個測試
會被識別爲:
這是一個測試
這是一個測試
從上面的例子我們可以看到,用`包裹的內容爲行內的代碼引用。如果是以縮進爲開頭的語句,則會是整行的引用。
總結
所有樣式總結如下:
# 標題1 ## 標題2 ### 標題3 #### 標題4 ##### 標題5 ###### 標題6 1.(空格)有序列表1 2.(空格)有序列表2 -(空格)無序列表1 -(空格)無序列表2 [鏈接名](鏈接地址) ![](鏈接圖片) (>)(空格)引用——去掉大於號左右的括號 *傾斜* **加粗** *** 分割線 |line1|line2|line3|line4| |:--|--:|:-:|---| |111|222|333|444| |111|222|333|444| 這是一個`測試` 這是一個測試