Markdown語法手冊(cè)—完整筆記整理
Markdown 是一種輕量級(jí)標(biāo)記語言,創(chuàng)始人為約翰·格魯伯(John Gruber)。 它允許人們使用易讀易寫的純文本格式編寫文檔,然后轉(zhuǎn)換成有效的 XHTML(或者HTML)文檔。這種語言吸收了很多在電子郵件中已有的純文本標(biāo)記的特性。
由于 Markdown 的輕量化、易讀易寫特性,并且對(duì)于圖片,圖表、數(shù)學(xué)式都有支持,許多網(wǎng)站都廣泛使用 Markdown 來撰寫幫助文檔或是用于論壇上發(fā)表消息。 如 GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、簡(jiǎn)書等,甚至還能被使用來撰寫電子書。
幾乎所有Markdown應(yīng)用程序都支持John Gruber原始設(shè)計(jì)文檔中概述的基本語法。Markdown處理器之間存在細(xì)微的差異和差異-盡可能在線內(nèi)注明。
標(biāo)題
要?jiǎng)?chuàng)建標(biāo)題,請(qǐng)#
在單詞或短語的前面添加數(shù)字符號(hào)()。您使用的數(shù)字符號(hào)的數(shù)量應(yīng)與標(biāo)題級(jí)別相對(duì)應(yīng)。例如,要?jiǎng)?chuàng)建標(biāo)題級(jí)別三(<h3>
),請(qǐng)使用三個(gè)數(shù)字符號(hào)(例如### My Header
)。
Markdown | HTML | |
---|---|---|
# Heading level 1 | <h1>Heading level 1</h1> | |
## Heading level 2 | <h2>Heading level 2</h2> | |
### Heading level 3 | <h3>Heading level 3</h3> | |
#### Heading level 4 | <h4>Heading level 4</h4> | |
##### Heading level 5 | <h5>Heading level 5</h5> | |
###### Heading level 6 | <h6>Heading level 6</h6> |
替代語法
或者,在文本下方的行上,添加任意數(shù)量的==
標(biāo)題級(jí)別1的--
字符或標(biāo)題級(jí)別2的字符。
Markdown | HTML | |
---|---|---|
Heading level 1 | <h1>Heading level 1</h1> | |
Heading level 2 | <h2>Heading level 2</h2> |
段落
要?jiǎng)?chuàng)建段落,請(qǐng)使用空白行分隔一行或多行文本。您不應(yīng)縮進(jìn)帶有空格或制表符的段落。
Markdown | HTML | |
---|---|---|
I really like using Markdown. | <p>I really like using Markdown.</p> |
換行
要?jiǎng)?chuàng)建換行符(<br>
),請(qǐng)以兩個(gè)或多個(gè)空格結(jié)束一行,然后鍵入return。
Markdown | HTML | |
---|---|---|
This is the first line. | <p>This is the first line.<br> |
著重
您可以通過使文本變?yōu)榇煮w或斜體來增加著重。
粗體
要加粗文本,請(qǐng)?jiān)趩卧~或短語的前后添加兩個(gè)星號(hào)或下劃線。要加粗一個(gè)單詞的中部以強(qiáng)調(diào),請(qǐng)?jiān)谧帜钢車砑觾蓚€(gè)星號(hào),且各空格之間不加空格。
Markdown | HTML | 渲染輸出 |
---|---|---|
I just love **bold text**. | I just love <strong>bold text</strong>. | 我只喜歡粗體字。 |
I just love __bold text__. | I just love <strong>bold text</strong>. | 我只喜歡粗體字。 |
Love**is**bold | Love<strong>is</strong>bold | 愛是大膽的 |
斜體
要斜體顯示文本,請(qǐng)?jiān)趩卧~或短語的前后添加一個(gè)星號(hào)或下劃線。要斜體突出單詞的中間部分,請(qǐng)?jiān)谧帜钢車砑右粋€(gè)星號(hào),中間不要帶空格。
Markdown | HTML | 渲染輸出 |
---|---|---|
Italicized text is the *cat's meow*. | Italicized text is the <em>cat's meow</em>. | 斜體文字是貓的叫聲。 |
Italicized text is the _cat's meow_. | Italicized text is the <em>cat's meow</em>. | 斜體文字是貓的叫聲。 |
A*cat*meow | A<em>cat</em>meow | 一個(gè)貓喵 |
粗體和斜體
要同時(shí)突出顯示帶有粗體和斜體的文本,請(qǐng)?jiān)趩卧~或短語的前后添加三個(gè)星號(hào)或下劃線。
Markdown | HTML | 渲染輸出 |
---|---|---|
This text is ***really important***. | This text is <strong><em>really important</em></strong>. | 這段文字真的很重要。 |
This text is ___really important___. | This text is <strong><em>really important</em></strong>. | 這段文字真的很重要。 |
This text is __*really important*__. | This text is <strong><em>really important</em></strong>. | 這段文字真的很重要。 |
This text is **_really important_**. | This text is <strong><em>really important</em></strong>. | 這段文字真的很重要。 |
塊引用
要?jiǎng)?chuàng)建blockquote,請(qǐng)>
在段落前面添加一個(gè)。
> Dorothy followed her through many of the beautiful rooms in her castle.
呈現(xiàn)的輸出如下所示:
桃樂絲(Dorothy)跟著她走過了她城堡中許多美麗的房間。
具有多個(gè)段落的塊引用
塊引用可以包含多個(gè)段落。>
在段落之間的空白行上添加一個(gè)。
> Dorothy followed her through many of the beautiful rooms in her castle. > > The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
呈現(xiàn)的輸出如下所示:
桃樂絲(Dorothy)跟著她走過了她城堡中許多美麗的房間。
女巫請(qǐng)她清洗鍋碗瓢盆,掃地,并用木柴取火。
嵌套塊引用
塊引用可以嵌套。>>
在要嵌套的段落前面添加一個(gè)。
> Dorothy followed her through many of the beautiful rooms in her castle. > >> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
呈現(xiàn)的輸出如下所示:
桃樂絲(Dorothy)跟著她走過了她城堡中許多美麗的房間。
女巫請(qǐng)她清洗鍋碗瓢盆,掃地,并用木柴取火。
具有其他元素的塊引用
塊引用可以包含其他Markdown格式的元素。并非所有元素都可以使用-您需要進(jìn)行實(shí)驗(yàn)以查看哪些元素有效。
> #### The quarterly results look great! > > - Revenue was off the chart. > - Profits were higher than ever. > > *Everything* is going according to **plan**.
呈現(xiàn)的輸出如下所示:
季度業(yè)績(jī)看起來不錯(cuò)!
- 收入超出了預(yù)期。
- 利潤(rùn)比以往任何時(shí)候都高。
一切都按計(jì)劃進(jìn)行。
清單
您可以將項(xiàng)目組織成有序和無序列表。
有序列表
要?jiǎng)?chuàng)建有序列表,請(qǐng)?jiān)谟唵雾?xiàng)中添加數(shù)字和句點(diǎn)。數(shù)字不必按數(shù)字順序排列,但列表應(yīng)以數(shù)字開頭。
Markdown | HTML | 渲染輸出 |
---|---|---|
1. First item | <ol> |
|
1. First item | <ol> |
|
1. First item | <ol> |
|
1. First item | <ol> |
|
無序列表
要?jiǎng)?chuàng)建無序列表,請(qǐng)?jiān)谟唵雾?xiàng)前添加破折號(hào)(-
),星號(hào)(*
)或加號(hào)(+
)。縮進(jìn)一個(gè)或多個(gè)項(xiàng)目以創(chuàng)建嵌套列表。
Markdown | HTML | 渲染輸出 |
---|---|---|
- First item | <ul> |
|
* First item | <ul> |
|
+ First item | <ul> |
|
- First item | <ul> |
|
在列表中添加元素
要在保留列表連續(xù)性的同時(shí)在列表中添加另一個(gè)元素,請(qǐng)將該元素縮進(jìn)四個(gè)空格或一個(gè)制表符,如以下示例所示。
段落
* This is the first list item. * Here's the second list item. I need to add another paragraph below the second list item. * And here's the third list item.
呈現(xiàn)的輸出如下所示:
- 這是第一個(gè)列表項(xiàng)。
這是第二個(gè)列表項(xiàng)。
我需要在第二個(gè)列表項(xiàng)下面添加另一段。
- 這是第三個(gè)列表項(xiàng)。
塊引用
* This is the first list item. * Here's the second list item. > A blockquote would look great below the second list item. * And here's the third list item.
呈現(xiàn)的輸出如下所示:
- 這是第一個(gè)列表項(xiàng)。
這是第二個(gè)列表項(xiàng)。
在第二個(gè)列表項(xiàng)的下方,blockquote看起來不錯(cuò)。
- 這是第三個(gè)列表項(xiàng)。
代碼塊
代碼塊通??s進(jìn)四個(gè)空格或一個(gè)制表符。當(dāng)它們?cè)诹斜碇袝r(shí),將它們縮進(jìn)八個(gè)空格或兩個(gè)選項(xiàng)卡。
1. Open the file. 2. Find the following code block on line 21: <html> <head> <title>Test</title> </head> 3. Update the title to match the name of your website.
呈現(xiàn)的輸出如下所示:
- 打開文件。
在第21行找到以下代碼塊:
<html> <head> <title>Test</title> </head>
- 更新標(biāo)題以匹配您的網(wǎng)站名稱。
圖片
1. Open the file containing the Linux mascot. 2. Marvel at its beauty.  3. Close the file.
呈現(xiàn)的輸出如下所示:
- 打開包含Linux吉祥物的文件。
驚嘆于它的美麗。
- 關(guān)閉文件。
代碼
要將單詞或短語表示為代碼,請(qǐng)將其括在勾號(hào)(`
)中。
Markdown | HTML | 渲染輸出 |
---|---|---|
At the command prompt, type `nano`. | At the command prompt, type <code>nano</code>. | 在命令提示符下,鍵入nano 。 |
轉(zhuǎn)義刻度線
如果要表示為代碼的單詞或短語包含一個(gè)或多個(gè)刻度線,可以通過將單詞或短語括在雙刻度線(``
)中來對(duì)其進(jìn)行轉(zhuǎn)義。
Markdown | HTML | 渲染輸出 |
---|---|---|
``Use `code` in your Markdown file.`` | <code>Use `code` in your Markdown file.</code> | Use `code` in your Markdown file. |
代碼塊
要?jiǎng)?chuàng)建代碼塊,請(qǐng)?jiān)诖a塊的每一行縮進(jìn)至少四個(gè)空格或一個(gè)制表符。
<html> <head> </head> </html>
呈現(xiàn)的輸出如下所示:
<html> <head> </head> </html>
水平線
要?jiǎng)?chuàng)建水平線***
,請(qǐng)單獨(dú)在一行上使用三個(gè)或更多的星號(hào)(),破折號(hào)(---
)或下劃線(___
)。
*** --- _________________
所有這三個(gè)的渲染輸出看起來都相同:
鏈接
要?jiǎng)?chuàng)建鏈接,請(qǐng)將鏈接文本括在方括號(hào)(例如[Duck Duck Go]
)中,然后立即在URL后面加上括號(hào)(例如(https://duckduckgo.com)
)中的URL 。
My favorite search engine is [Duck Duck Go](https://duckduckgo.com).
呈現(xiàn)的輸出如下所示:
我最喜歡的搜索引擎是Duck Duck Go。
添加標(biāo)題
您可以選擇為鏈接添加標(biāo)題。當(dāng)用戶將鼠標(biāo)懸停在鏈接上時(shí),這將顯示為工具提示。要添加標(biāo)題,請(qǐng)將其括在URL后面的括號(hào)中。
My favorite search engine is [Duck Duck Go](https://duckduckgo.com "The best search engine for privacy").
呈現(xiàn)的輸出如下所示:
我最喜歡的搜索引擎是Duck Duck Go。
網(wǎng)址和電子郵件地址
要將URL或電子郵件地址快速轉(zhuǎn)換為鏈接,請(qǐng)將其括在尖括號(hào)中。
<https://markdown.p2hp.com> <fake@example.com>
呈現(xiàn)的輸出如下所示:
https://markdown.p2hp.com
fake@example.com
格式化鏈接
為了強(qiáng)調(diào)鏈接,請(qǐng)?jiān)诜嚼ㄌ?hào)和括號(hào)之前和之后添加星號(hào)。
I love supporting the **[EFF](https://eff.org)**. This is the *[Markdown Guide](https://markdown.p2hp.com)*.
呈現(xiàn)的輸出如下所示:
我喜歡支持EFF。
這是《Markdown指南》。
參考樣式鏈接
引用樣式鏈接是一種特殊的鏈接,它使URL在Markdown中更易于顯示和閱讀。引用樣式的鏈接分為兩部分:與文本保持內(nèi)聯(lián)的部分以及在文件中其他位置存儲(chǔ)的部分,以使文本易于閱讀。
格式化鏈接的第一部分
參考樣式鏈接的第一部分使用兩組括號(hào)進(jìn)行格式化。第一組方括號(hào)包圍應(yīng)顯示為鏈接的文本。第二組括號(hào)顯示了一個(gè)標(biāo)簽,該標(biāo)簽用于指向您存儲(chǔ)在文檔其他位置的鏈接。
盡管不是必需的,但您可以在第一組和第二組支架之間包含一個(gè)空格。第二組括號(hào)中的標(biāo)簽不區(qū)分大小寫,可以包含字母,數(shù)字,空格或標(biāo)點(diǎn)符號(hào)。
這意味著以下示例格式對(duì)于鏈接的第一部分大致相同:
[hobbit-hole][1]
[hobbit-hole] [1]
格式化鏈接的第二部分
引用樣式鏈接的第二部分使用以下屬性設(shè)置格式:
- 標(biāo)簽放在方括號(hào)中,后緊跟冒號(hào)和至少一個(gè)空格(例如
[label]:
)。 - 鏈接的URL,您可以選擇將其括在尖括號(hào)中。
- 鏈接的可選標(biāo)題,您可以將其括在雙引號(hào),單引號(hào)或括號(hào)中。
這意味著以下示例格式對(duì)于鏈接的第二部分幾乎都是等效的:
[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle
[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle "Hobbit lifestyles"
[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle 'Hobbit lifestyles'
[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle (Hobbit lifestyles)
[1]: <https://en.wikipedia.org/wiki/Hobbit#Lifestyle> "Hobbit lifestyles"
[1]: <https://en.wikipedia.org/wiki/Hobbit#Lifestyle> 'Hobbit lifestyles'
[1]: <https://en.wikipedia.org/wiki/Hobbit#Lifestyle> (Hobbit lifestyles)
您可以將鏈接的第二部分放在Markdown文檔中的任何位置。有些人將它們放在出現(xiàn)的段落之后,而其他人則將它們放在文檔的末尾(例如尾注或腳注)。
將零件放在一起的示例
假設(shè)您添加一個(gè)URL作為到段落的標(biāo)準(zhǔn)URL鏈接,并且在Markdown中看起來像這樣:
In a hole in the ground there lived a hobbit. Not a nasty, dirty, wet hole, filled with the ends of worms and an oozy smell, nor yet a dry, bare, sandy hole with nothing in it to sit down on or to eat: it was a [hobbit-hole](https://en.wikipedia.org/wiki/Hobbit#Lifestyle "Hobbit lifestyles"), and that means comfort.
盡管它可能指向有趣的附加信息,但顯示的URL確實(shí)不會(huì)給現(xiàn)有的原始文本增加太多,除了使其難以閱讀之外。要解決此問題,您可以改為設(shè)置網(wǎng)址格式:
In a hole in the ground there lived a hobbit. Not a nasty, dirty, wet hole, filled with the ends of worms and an oozy smell, nor yet a dry, bare, sandy hole with nothing in it to sit down on or to eat: it was a [hobbit-hole][1], and that means comfort. [1]: <https://en.wikipedia.org/wiki/Hobbit#Lifestyle> "Hobbit lifestyles"
在上述兩種情況下,呈現(xiàn)的輸出將相同:
在地上的一個(gè)洞里住著一個(gè)霍比特人。這不是一個(gè)骯臟,骯臟,潮濕的洞,里面充滿蠕蟲的末端和難聞的氣味,也沒有一個(gè)干燥,裸露,沙質(zhì)的洞,里面沒有東西可以坐下或進(jìn)食:那是一個(gè)霍比特洞,意味著舒適。
鏈接HTML為:
<a rel="external nofollow" title="Hobbit lifestyles">hobbit-hole</a>
圖片
要添加圖像,請(qǐng)?zhí)砑痈袊@號(hào)(!
),然后在括號(hào)中添加替代文本,并在括號(hào)中添加圖像資源的路徑或URL。您可以選擇在括號(hào)中的URL之后添加標(biāo)題。

呈現(xiàn)的輸出如下所示:
鏈接圖像
要向圖像添加鏈接,請(qǐng)將圖像的Markdown括在方括號(hào)中,然后在括號(hào)中添加鏈接。
[](https://www.flickr.com/photos/beaurogers/31833779864/in/photolist-Qv3rFw-34mt9F-a9Cmfy-5Ha3Zi-9msKdv-o3hgjr-hWpUte-4WMsJ1-KUQ8N-deshUb-vssBD-6CQci6-8AFCiD-zsJWT-nNfsgB-dPDwZJ-bn9JGn-5HtSXY-6CUhAL-a4UTXB-ugPum-KUPSo-fBLNm-6CUmpy-4WMsc9-8a7D3T-83KJev-6CQ2bK-nNusHJ-a78rQH-nw3NvT-7aq2qf-8wwBso-3nNceh-ugSKP-4mh4kh-bbeeqH-a7biME-q3PtTf-brFpgb-cg38zw-bXMZc-nJPELD-f58Lmo-bXMYG-bz8AAi-bxNtNT-bXMYi-bXMY6-bXMYv)
呈現(xiàn)的輸出如下所示:
轉(zhuǎn)義字符
要顯示原義字符,否則將用于設(shè)置Markdown文檔中的文本格式\
,請(qǐng)?jiān)谧址懊嫣砑臃葱备埽ǎ?/p>
\* Without the backslash, this would be a bullet in an unordered list.
呈現(xiàn)的輸出如下所示:
*如果沒有反斜杠,這將是無序列表中的項(xiàng)目符號(hào)。
你可以轉(zhuǎn)義的字符
您可以使用反斜杠轉(zhuǎn)義以下字符。
字符 | 名稱 |
---|---|
\ | 反斜杠 |
` | 刻度線 |
* | 星號(hào) |
_ | 下劃線 |
{} | 大括號(hào) |
[] | 中括號(hào) |
() | 括號(hào) |
# | 井號(hào) |
+ | 加號(hào) |
- | 減號(hào)(連字符) |
. | 點(diǎn) |
! | 感嘆號(hào) |
| | 管道 |
相關(guān)文章
鴻蒙UI開發(fā)之滾動(dòng)組件overscroll-decor安裝和使用介紹
鴻蒙UI開發(fā)之滾動(dòng)組件overscroll-decor?是一個(gè)開源庫(kù),提供一種簡(jiǎn)單、靈活的方式來實(shí)現(xiàn)各種過度滾動(dòng)(overscroll)動(dòng)畫效果,提升用戶的交互體驗(yàn),該庫(kù)提供了類似于iOS的過度滾動(dòng)效果,幾乎可以應(yīng)用于所有Android,如RecyclerView、ListView、GridView、ScrollView等?2024-12-12http請(qǐng)求405錯(cuò)誤方法不被允許的解決 (Method not allowed)
這篇文章主要介紹了http請(qǐng)求405錯(cuò)誤方法不被允許的解決 (Method not allowed),文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-12-12Linux上設(shè)置Ollama服務(wù)配置(常用環(huán)境變量)
本文主要介紹了Linux上設(shè)置Ollama服務(wù)配置(常用環(huán)境變量),Ollama提供了多種環(huán)境變量供配置,如調(diào)試模式、模型目錄等,下面就來介紹一下,感興趣的可以了解一下2025-03-03Git的基本操作流程及工作區(qū)版本庫(kù)暫存區(qū)的關(guān)系
這篇文章主要為大家介紹了Git的基本操作流程及工作區(qū)版本庫(kù)暫存區(qū)的關(guān)系,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-04-04如何在本地部署DeepSeek大模型實(shí)現(xiàn)聯(lián)網(wǎng)增強(qiáng)的AI應(yīng)用
本文介紹了如何使用Microsoft?SemanticKernel框架結(jié)合DeepSeek本地模型和自定義搜索技能,構(gòu)建一個(gè)具備聯(lián)網(wǎng)增強(qiáng)能力的智能應(yīng)用,文章還提供了一個(gè)應(yīng)用場(chǎng)景示例,說明如何在本地部署DeepSeek大模型并實(shí)現(xiàn)聯(lián)網(wǎng)增強(qiáng)的AI應(yīng)用,感興趣的朋友一起看看吧2025-02-02