關於Markdown
Markdown語法的目標:成為一種適用於網絡的書寫語言,並且「易寫易讀」。
本文的目的:使讀者輕鬆瞭解簡書對 Markdown 語法的支持,瞭解其優點和不足。能夠在選擇時正確取捨,使用時得心應手。
一、區塊標記
區塊標記:是指內容獨佔一塊,需前後換行,不和其他標記共處一行的標記。
1、段落
段落:即是一段連續的文字,可包含*、空格、換行、tab等字符。兩個段落之間使用空行分隔。
示例代碼:
效果:
Tips: 換行不是分段的標識,空行才是
2、標題
標題: 代表了文章中主題的層次,比如:文章標題使用一級標題,回目使用二級標題,小節使用三級標題,以此類推。主題的層次代表了文章的大綱。
語法:Markdown 中使用連續的 n(1-6) 個 # 分別表示第 n 級標題。
示例代碼:
效果:
Tips:# 和後續內容之間應放置一個空格。
3、列表
列表:就是一組相關信息的集合。Markdown中的列表分為 有序列表 和 無序列表。
1. 有序列表
語法:使用 數字 + . 作為項目符號,項目符號和正式列表項目之間有一個空格。
示例代碼:
效果:
2. 無序列表
語法:使用 * 作為項目符號,項目符號和正式列表項目之間有一個空格。
示例代碼:
效果:
Tips:
a. 無序列表的項目符號可使用 *,+,- 效果是相同的。
b. 列表與後續內容之間需要一個空行隔開,即:列表是一個段落。
c. 列表允許多層次嵌套。
d. 可以在項目中包含段落,只需將段落前添加一個 tab 或 4 個空格。
4、分割線
語法:使用 3 個連續的 * 即可得到一個分割線
示例代碼:
效果:
5、引用
語法:在行頭加上 > 即可。
二、行內標記
行內標記和其他標記共處一行。
1、強調文字
a. 斜體
語法:使用前後各 1 個 *(或_) 包含的文字是 斜體 文字
示例代碼:
效果:
b. 粗體
語法: 使用前後各 2 個 *(或_) 包含的文字是 粗體 文字
示例代碼:
效果:
c. 刪除文字
語法:使用前後各 2 個 ~ 包含的文字是刪除文字
示例代碼:
效果:
d. 粗斜體
語法:在**(或__)中嵌套_ (或*) 或 在_(或*)中嵌套**(或__)即可得到 粗斜體。
示例代碼:
效果:
2、圖片與鏈接
I. 行內圖片
語法:![圖片標題](圖片url)
示例代碼:
效果:
II. 引用圖片
語法:
![圖片標題][圖片id]
[圖片id]:圖片url
示例代碼:
效果:
b. 鏈接:行內鏈接、鏈接引用、自動鏈接
i. 行內鏈接
語法:[鏈接名稱](鏈接地址 url "鏈接title")
示例代碼:
效果:
ii. 鏈接引用
語法:
[鏈接名稱][鏈接id]
[鏈接id]:鏈接 url 地址 "鏈接 title"
示例代碼:
效果:
3、表格
語法:
a. 第一行為表頭,第二行分隔表頭和主體部分,第三行開始每一行為一個表格行。
b. 列於列之間用管道符 | 隔開。表格每一行兩邊的管道符可省略。
c. 第二行還可以為不同的列指定對齊方向。標題默認為居中對齊,內容默認為左對齊;在 - 左邊加上 : 就是左對齊;在 - 右邊加上 : 就是右對齊;在 - 兩邊都加上 : 就是居中對齊。
示例代碼:
效果:
注:
由於本人初來乍到,水平有限,難免有疏漏錯誤,萬望指教,不勝感激。
閱讀更多 ybowang 的文章