Markdown 學習筆記
Markdown 標題(title)
# heading level 1
## heading level 2
### heading level 3
#### heading level 4
##### heading level 5
###### heading level 6
heading level 1
heading level 2
heading level 3
heading level 4
heading level 5
heading level 6
可以在文本下方添加任意數(shù)量的==號來標識一級標題,或者--號來標識二級標題
heading level 1
===
heading level 2
---
heading level 1
heading level 2
Markdown 段落(Paragraph)
要創(chuàng)建段落,使用空白行將一行或者多行文本進行分隔。
空白行可以分為兩個段落
段落不要用空格(spaces)和制表符(tabs)
Markdown 換行語法
在一行的末尾添加兩個或多個空格,然后按回車鍵,即可創(chuàng)建一個換行 ? 也可以使用HTML的
標簽來實現(xiàn)換行第一行<br>第二行
第一行 第二行
換行與段落的區(qū)別在于換行后兩行是挨著的,而段落之間有一個空行。
Markdown 強調語法
粗體(Bold)
要加粗文本,需要在短語的前后各添加兩個星號(asterisks)或下劃線(underscores)。如果需要加粗一個單詞或者短語的中間部分用以表示強調的話,則需要在加粗部分的兩側各添加兩個星號(asterisks)。
**test**
test
推薦使用星號
斜體(Italic)
要用斜體顯示文本,需要在單詞或短語前后添加一個星號(asterisks)或者下劃線(underscore)。要是斜體單詞在中間部分,則需要在字母前后各添加一個星號,中間不要帶空格。
*test*
test
如果需要同時粗體和斜體,則可以在單詞或短語的前后各添加三個星號或下劃線。推薦使用星號。
Markdown 引用語法
創(chuàng)建塊引用,需要在段落前添加一個 > 符號
引用test
塊應用可以包含多個段落。為段落之間的空白行添加一個 > 符號
嵌套塊引用
在需要嵌套的段落前添加一個 >> 符號
>first
>>second
first
second
帶有其他元素的塊引用
可以引用其他塊元素,如無序列表。
Markdown 列表語法
有序列表
要創(chuàng)建有序列表,需要在每個列表項前添加數(shù)字并緊跟一個英文句點。數(shù)字不必按數(shù)學順序排列,但是列表應當以數(shù)字1開始。
1. First
? ?1. first
2. Third
First
first
Third
2.1
無序列表
創(chuàng)建無需列表,可以在每個列表前面添加破折號(-),星號(*),加號(+)。縮進一個或多個列表項可創(chuàng)建嵌套列表。 建議選擇一個只用即可。
- 1
- 2
1
2
在列表中嵌套其他元素使用
要么保留列表連續(xù)性的同時在列表中添加另一種元素,請將該元素縮進四個空格或一個制表符。
* The first list item.
? ?the middle of the list
* The second list item.
The first list item. the middle of the list
The second list item. 并且可以添加引用塊。
代碼塊
代碼塊通常采用四個空格或一個制表符縮進。當它們被放在列表中時,請縮進為八個空格或者兩個制表符。
圖片
同圖片格式
列表
可以在列表中嵌套
代碼
如果要將單詞或者短語表示為代碼,請將其包括在反引號內 test
轉義反引號
如果需要表示為代碼的單詞或短語中包含一個或者多個反引號,則可以通過將單詞或短語包括在雙反引號中
``show the `sym` symbol``
show the `sym` symbol
代碼塊
創(chuàng)建代碼塊,將代碼塊的每一行至少縮進四個空格或一個制表符,即可創(chuàng)建為代碼塊。
<html>
<head>
</head>
</html>
Markdown 分隔線語法
創(chuàng)建分隔線,請在單獨一行上使用三個或多個星號(***),破折號(---),或者下劃線(___),并且不能包含其他內容。
---
為了兼容性,在分隔線前后均添加空白行。
Markdown 鏈接語法
鏈接文本放在中括號中,鏈接地址放在后面的括號中,鏈接title可選。超鏈接Markdown語法 ? ?代碼 : [ 超鏈接顯示名 ]( 超鏈接地址"超鏈接title" )
給連接增加title
鏈接title是當鼠標懸停在鏈接上時會出現(xiàn)的文字,這個title是可選的,它放在圓括號鏈接地址后面,跟鏈接地址之間以空格分隔。
這是一個鏈接 [Markdown語法](https://markdown.com.cn "最好的markdown教程")。
這是一個鏈接
。網址和Email地址
使用尖括號可以很方便地把URL或者Email地址變成可點擊的鏈接。
<https://markdown.com.cn>
https://markdown.com.cn
帶格式化的鏈接
強調鏈接,在鏈接語法前后增加星號。要將鏈接表示為代碼,請在方括號中添加反引號。
test website **[Markdown Guide](https://www.markdownguide.org)**.
this is the code format [`code`](#code).
test website . this is the code format .
引用類型鏈接
引用樣式鏈接是一種特殊的鏈接,它使URL在markdown中更易于顯示和閱讀。參考樣式鏈接分為兩部分:與文本保持內聯(lián)部分以及存儲在文件中其他位置的部分,以使文本抑郁閱讀。
鏈接的兩個部分
引用類型的鏈接的第一部分是用兩組括號進行格式設置。第一組方括號包圍顯示為鏈接的文本。第二組括號顯示一個標簽,該標簽用于指向你存儲在文檔其他位置的鏈接。 盡管不是必需的,但推薦在第一組和第二組括號之間包含一個空格。第二組括號中的標簽不區(qū)分大小寫,可以包含字母,數(shù)字,空格和標點符號。
[title][id]
簡而言之呢,就是給需要引用鏈接處再添加一個id,在最后用id添加需要引用的鏈接。
[id]: the website
即下面這種方式也可以實現(xiàn)引用鏈接,使代碼可讀性更好。
[Markdown guide][1]
[1]: https://www.markdownguide.org
[1] ? ?https://www.markdownguide.org?
這樣可以使Markdown代碼的可讀性提高。
推薦使用%20代替空格
[link](https://www.example.com/my%20great%20page)
圖片
要添加圖像,請使用感嘆號 (
) ,然后在方括號增加替代文本,圖片鏈接放在圓括號里,括號里的鏈接后可以增加一個可選的圖片標題文本。

鏈接圖片
給圖片增加鏈接,請將圖像內的Markdown括在方括號中,然后將鏈接添加在圓括號中。
[](https://cn.bing.com/search?q=%e9%9c%8d%e5%b0%94%e6%96%af%e6%bb%95%e9%97%a8&form=hpcapt&filters=HpDate:%2220230228_1600%22)

轉義字符語法
要顯示原本用于格式化Markdown文檔的字符,請在字符前面添加反斜杠字符\。
\*test\*
*test*
以下字符都可以使用反斜杠字符總而達到轉移目的:\,`,*,_,[],{},(),#,+,-,.,!,|.
特殊字符自動轉義
在HTML文件中,有兩個字符需要特殊處理
, , 符號用于起始標簽, 用于標記HTML實體,如果你只是想要使用這些符號,那必須要使用實體的形式,像是 ,和 。簡而言之,Markdown允許你直接只用這兩個符號,會幫你自動轉移。但如果你使用
作為HTML實體的一部分,或者使用 作為HTML標簽的分隔符,那Markdown將不會對其做任何轉換,其他搶礦則會被轉換。Markdown內嵌HTML標簽
對于Markdown涵蓋范圍之外的標簽,都可以直接在文件里用HTML本身。如需要使用HTML,不需要額外標注這是HTML或是Markdown,只需要HTML標簽添加到Markdown文本中即可。
行級內聯(lián)標簽
HTML的行級內聯(lián)標簽如
, , 不受限制,可以在Markdown的段落、列表或是標題里任意使用。**bold**,<em>italic</em>
bold,italic
區(qū)塊標簽
區(qū)塊元素比如,
, , , ,等標簽,必須在前后加上空行,以便于內容區(qū)分。 Markdown語法在HTML區(qū)塊標簽中將不會被進行處理。 如需要使用HTML標簽的子集,請查看相應的Markdown應用程序的手冊。