概述
設計理念
Markdown 致力於使閱讀和創作文檔變得容易. 是用於 創作 web 文檔的.
Markdown 從不想取代 HTML,也沒有要和它相近,它的語法集合非常小,只對應一小部分 HTML 標籤. 它要做的 不是 創造一種新的語法以使插入 HTML 標籤變得更容易。在我看來, HTML 已經很容易寫了。Markdown 的目標是易於閱讀, 創作和編輯文章. HTML 是一種 發佈 格式; Markdown 是一種 創作 格式. 因此, Markdown 處理的都是純文本。
塊狀元素
段落和換行
- 段落 :就是連續的文本行
- 換行:Markdown不會自動換行(直接輸入enter),需要在需要換行的文本行末尾加入兩個空格再enter纔可以實現換行
- 一個或多個空行劃分不同的段落. (空行的含義就只要是看起來是空行就行了 – 即使包含了 spaces 或者 等空白符也是空行.) 普通段落不應該使用縮進。
標題
Markdown 支持兩種形式的標題, [Setext] 1 和 [atx] 2.
- Setext 樣式的標題使用的等號來表示一級標題, 使用連字符表示二級標題.任意長度的 = 或 - 都是可以的. 如
binge
binge2
- Atx 樣式的標題每行開頭使用 1-6 井號, 對應 1-6 級標題. # ,## ,### ···,但是最後一個#後要加個空格再加入標題文字
塊引用
- 在每一個需要強制換行的段落的首行前面加上一個 >
- 塊引用也可以嵌套 > >
- 塊內部也也已加上標題,列表和代碼塊等元素
列表
列表分爲有序表和無序表(表可以多層嵌套)
- 無序表:在文本行前加上 * - + 都可以,記得加上空格
- 有序表:在文本行前加上數字. ,記得加上空格
代碼塊
-
markdown:原生 Markdown只需要將每一行都縮進 4 個空格或者 1 個水平製表符縮進即可生成代碼區塊,代碼塊自動擴展直到碰到未使用縮進的文本 (或者文章結尾)
-
GFM(Github Flavored Markdown ) :圍欄式代碼區塊,在代碼上下一行使用三個反引號 ```, 並在第一行反引號後自定義代碼語種
水平分割線
如果一行中只有三個以上的連字符(-), 星號(*), 或者下劃線(_), 星號和連字符之間的空格也是允許的. 都會生成一條水平線:
內聯元素
Markdown 支持兩種鏈接形式: 行內式 和 參考式.這兩種形式下鏈接文本的定界符都是 [中括號]
鏈接
- 行內式鏈接 : 【鏈接文字】(鏈接網址 “標題”)
> [百度](https://www.baidu.com "baidu.com")
- 參考形式 : 爲參考形式的鏈接定一個 [名稱] 方便我們在文章中多次引用(鏈接名稱可以用字母、數字和空格,但是不分大小寫)。
【鏈接文字】[標題]
> 遇到問題,可[谷歌][1],也可[百度][2],又可[bing][3]
[1]: https://www.google.com/ "Google"
[2]: https://www.baidu.com/ "Baidu Search"
[3]: https://cn.bing.com/ "Bing Search"
- 自動形式鏈接
https://www.baidu.com/
https://www.baidu.com/
強調
Markdown 將星號 (*) 和下劃線 (_) 作爲強調標記.
加粗: 四個*或者_包裹的內容爲加粗 如:** binge **,*與文本間無空格
**binge**
__binge__
binge
binge
斜體 : 兩個或者_包裹的內容爲加粗 如: binge *,*與文本間無空格
*binge*
_binge_
binge
binge
圖片
通常, 要用 “原生” 的語法在純文本格式中插入圖片是很困難的.
Markdown 使用了類似鏈接的語法來插入圖片, 包含兩種形式:行內式和參考式(像鏈接)
- 行內式 :
![Alt屬性](圖片URL "title")
一個感嘆號: !;
緊跟着一對方括號, 包含了圖片的 alt 屬性;
緊跟着一對圓括號, 包含了圖片的 URL 或者路徑, 以及一個可選的用單引號或雙引號包裹的 title 屬性.
![百度](https://www.baidu.com/img/bd_logo1.png?where=super)
- 參考式 !【鏈接文字】[ID]
(中間要加空行)
[ID] : URL “title”
![百度][1]
[1]: https://www.baidu.com/img/bd_logo1.png?where=super "百度"
拓展
反斜槓轉義 :
Markdown 中可以使用反斜槓轉義 Markdown 語法符號爲字面量. 例如, 如果你想用星號包圍一個單詞
*binge*
\*binge\*
binge
*binge*
Markdown 爲下面字符提供反斜槓轉義:
\ backslash
` backtick
* asterisk
_ underscore
{} curly braces
[] square brackets
() parentheses
# hash mark
+ plus sign
- minus sign (hyphen)
. dot
! exclamation mark
表格:
表格由行列組成,第一行是表頭,第二行指定表格內容佈局,第三行開始爲表格數據
- 同行之間用 | 分割不同的列,首尾也用。
- 同一張表格,各行的列數(單元格數)應該相同
- :- | :-: | -: 作爲表格標題與內容的分割標誌,同時控制內容的佈局, :- 表示左對齊,相應的後兩個爲居中和右對齊, - 數量不限,- 默認爲左對齊。
如:
| Left-標題 | Center-標題 | Right-標題 |
| :- | :-: | -: |
| b1 | b2 | b3 |
| d1 | d2 | d3 |
Left-標題 | Center-標題 | Right-標題 |
---|---|---|
b1 | b2 | b3 |
d1 | d2 | d3 |