一、概述#
Markdown是一種輕量級的標記語言,他的目標是實現易讀易寫,一份使用Markdown格式撰寫的文件可以直接以純文本發布,并且看起來不會像是由許多標簽或格式指令所構成。Markdown的語法目標是:成為一種適用于網絡的書寫語言。HTML是一種發布的格式,Markdown是一種書寫的格式。Markdown的格式語法只涵蓋文本可以涵蓋的范圍。我們可以使用Markdown:
- 整理知識,學習筆記
- 發布日記,雜文,所見所想
- 撰寫發布技術文稿(代碼支持)
- 撰寫發布學術論文
二、常用標記列舉
Markdown的語法全由一些符號所組成,這些符號經過精挑細選,其作用一目了然。
- 各種header,如
#
,##
,###
, 等等,以及====
,-----
- 文字修飾:
**
,__
- 分隔符:
-------
- 列表:無序
-
以及有序1.
- 圖片:
![]()
- 鏈接:
[]()
及<>
- 引用:
>
- 行內代碼:
code
, 以及代碼塊``` ```
- 表格
三、常用標記詳解
1、標題
(1)類Setext形式:=
(最高階標題) -
(第二階標題),任何數量的 = 和 - 都可以,例如:
注:在線Markdown編輯器上有效果,但Typore上沒有
(2)類Atx形式:在行首插入 1 到 6 個#
,對應標題 1 到 6 階,例如:
注:在線Markdown編輯器上#和文字中間需要有空格,而Typora上不需要加空格
2、區塊引用
在需要引用的首行最前面加上>
;區塊引用可以嵌套,只要根據層次加上不同數量的>
;引用的區塊也可以使用其他的Markdown語法,包括標題、列表、代碼區塊等,例如:
注:在線編輯器上沒有明顯效果,Typora效果如上圖
3、列表
(1)無序列表:使用*
,+
,或是-
作為列表標記,例如:
等同于:
也等同于:
注:在線編譯器標記與文字中間有空格才可以顯示,Typora不需要
(2)有序列表:使用數字接著一個英文句點,例如:
在列表標記上使用的數字不會影響輸出的結果,例如:
4、代碼區塊
(1)縮進 4 個空格或是 1 個制表符
(2)多行代碼,用```
包含代碼
(3)行內代碼,用 ` 包起來
5、分割線
在一行中用三個以上的*
,-
, _
來建立一個分割線,行內不能有其他東西,但可以在星號或者減號中間插入空格,例如:
6、鏈接
(1)行內式:方括號后緊跟圓括號并插入網址鏈接即可,若想要加上鏈接的title文字,在網址后面,用雙引號把title文字包起來即可,例如:
(2)參考式:在鏈接文字的括號后面再接上另一個方括號,而在第二個方括號里面要填入用以辨識鏈接的標記,可用于多個鏈接,例如:
注:在線編譯器無效果,Typora有效果
7、強調
(1)粗體:雙_
或雙*
,例如:
(2)斜體:單_
或單*
,例如:
8、圖片
語法與加鏈接類似,在最前面加一個感嘆號,例如:
9、表格
用-
分割第一行表格,用|
分割每一列,例如:
四、待解決問題
-
Markdown與HTML關系:
不在Markdown涵蓋范圍之內的標簽,都可以直接在文檔里面用HTML撰寫,不需要額外標注這是HTML或是Markdown,只要直接加標簽就可以了。
和處在HTML區塊標簽間不同,Markdown語法在HTML區段標簽間是有效的。
學習發現有很多類似上述比較Markdown和HTML的介紹,不知道是不是因為還沒有太了解HTML,里面很多介紹不是很明白,拿來驗證又得不到相應的效果。
-
不同編輯器效果不同
在使用Typora和免費在線markdown編輯器時發現,部分標簽顯示效果不同。具體不同在上一章節常用標記詳解中有注解。