Markdown語法手冊—完整筆記整理
Markdown 是一種輕量級標記語言,創(chuàng)始人為約翰·格魯伯(John Gruber)。 它允許人們使用易讀易寫的純文本格式編寫文檔,然后轉(zhuǎn)換成有效的 XHTML(或者HTML)文檔。這種語言吸收了很多在電子郵件中已有的純文本標記的特性。
由于 Markdown 的輕量化、易讀易寫特性,并且對于圖片,圖表、數(shù)學(xué)式都有支持,許多網(wǎng)站都廣泛使用 Markdown 來撰寫幫助文檔或是用于論壇上發(fā)表消息。 如 GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、簡書等,甚至還能被使用來撰寫電子書。
幾乎所有Markdown應(yīng)用程序都支持John Gruber原始設(shè)計文檔中概述的基本語法。Markdown處理器之間存在細微的差異和差異-盡可能在線內(nèi)注明。
標題
要創(chuàng)建標題,請#
在單詞或短語的前面添加數(shù)字符號()。您使用的數(shù)字符號的數(shù)量應(yīng)與標題級別相對應(yīng)。例如,要創(chuàng)建標題級別三(<h3>
),請使用三個數(shù)字符號(例如### 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ù)量的==
標題級別1的--
字符或標題級別2的字符。
Markdown | HTML | |
---|---|---|
Heading level 1 | <h1>Heading level 1</h1> | |
Heading level 2 | <h2>Heading level 2</h2> |
段落
要創(chuàng)建段落,請使用空白行分隔一行或多行文本。您不應(yīng)縮進帶有空格或制表符的段落。
Markdown | HTML | |
---|---|---|
I really like using Markdown. | <p>I really like using Markdown.</p> |
換行
要創(chuàng)建換行符(<br>
),請以兩個或多個空格結(jié)束一行,然后鍵入return。
Markdown | HTML | |
---|---|---|
This is the first line. | <p>This is the first line.<br> |
著重
您可以通過使文本變?yōu)榇煮w或斜體來增加著重。
粗體
要加粗文本,請在單詞或短語的前后添加兩個星號或下劃線。要加粗一個單詞的中部以強調(dià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 | 愛是大膽的 |
斜體
要斜體顯示文本,請在單詞或短語的前后添加一個星號或下劃線。要斜體突出單詞的中間部分,請在字母周圍添加一個星號,中間不要帶空格。
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 | 一個貓喵 |
粗體和斜體
要同時突出顯示帶有粗體和斜體的文本,請在單詞或短語的前后添加三個星號或下劃線。
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>. | 這段文字真的很重要。 |
塊引用
要創(chuàng)建blockquote,請>
在段落前面添加一個。
> Dorothy followed her through many of the beautiful rooms in her castle.
呈現(xiàn)的輸出如下所示:
桃樂絲(Dorothy)跟著她走過了她城堡中許多美麗的房間。
具有多個段落的塊引用
塊引用可以包含多個段落。>
在段落之間的空白行上添加一個。
> 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)跟著她走過了她城堡中許多美麗的房間。
女巫請她清洗鍋碗瓢盆,掃地,并用木柴取火。
嵌套塊引用
塊引用可以嵌套。>>
在要嵌套的段落前面添加一個。
> 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)跟著她走過了她城堡中許多美麗的房間。
女巫請她清洗鍋碗瓢盆,掃地,并用木柴取火。
具有其他元素的塊引用
塊引用可以包含其他Markdown格式的元素。并非所有元素都可以使用-您需要進行實驗以查看哪些元素有效。
> #### The quarterly results look great! > > - Revenue was off the chart. > - Profits were higher than ever. > > *Everything* is going according to **plan**.
呈現(xiàn)的輸出如下所示:
季度業(yè)績看起來不錯!
- 收入超出了預(yù)期。
- 利潤比以往任何時候都高。
一切都按計劃進行。
清單
您可以將項目組織成有序和無序列表。
有序列表
要創(chuàng)建有序列表,請在訂單項中添加數(shù)字和句點。數(shù)字不必按數(shù)字順序排列,但列表應(yīng)以數(shù)字開頭。
Markdown | HTML | 渲染輸出 |
---|---|---|
1. First item | <ol> |
|
1. First item | <ol> |
|
1. First item | <ol> |
|
1. First item | <ol> |
|
無序列表
要創(chuàng)建無序列表,請在訂單項前添加破折號(-
),星號(*
)或加號(+
)??s進一個或多個項目以創(chuàng)建嵌套列表。
Markdown | HTML | 渲染輸出 |
---|---|---|
- First item | <ul> |
|
* First item | <ul> |
|
+ First item | <ul> |
|
- First item | <ul> |
|
在列表中添加元素
要在保留列表連續(xù)性的同時在列表中添加另一個元素,請將該元素縮進四個空格或一個制表符,如以下示例所示。
段落
* 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)的輸出如下所示:
- 這是第一個列表項。
這是第二個列表項。
我需要在第二個列表項下面添加另一段。
- 這是第三個列表項。
塊引用
* 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)的輸出如下所示:
- 這是第一個列表項。
這是第二個列表項。
在第二個列表項的下方,blockquote看起來不錯。
- 這是第三個列表項。
代碼塊
代碼塊通??s進四個空格或一個制表符。當它們在列表中時,將它們縮進八個空格或兩個選項卡。
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>
- 更新標題以匹配您的網(wǎng)站名稱。
圖片
1. Open the file containing the Linux mascot. 2. Marvel at its beauty.  3. Close the file.
呈現(xiàn)的輸出如下所示:
- 打開包含Linux吉祥物的文件。
驚嘆于它的美麗。
- 關(guān)閉文件。
代碼
要將單詞或短語表示為代碼,請將其括在勾號(`
)中。
Markdown | HTML | 渲染輸出 |
---|---|---|
At the command prompt, type `nano`. | At the command prompt, type <code>nano</code>. | 在命令提示符下,鍵入nano 。 |
轉(zhuǎ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. |
代碼塊
要創(chuàng)建代碼塊,請在代碼塊的每一行縮進至少四個空格或一個制表符。
<html> <head> </head> </html>
呈現(xiàn)的輸出如下所示:
<html> <head> </head> </html>
水平線
要創(chuàng)建水平線***
,請單獨在一行上使用三個或更多的星號(),破折號(---
)或下劃線(___
)。
*** --- _________________
所有這三個的渲染輸出看起來都相同:
鏈接
要創(chuàng)建鏈接,請將鏈接文本括在方括號(例如[Duck Duck Go]
)中,然后立即在URL后面加上括號(例如(https://duckduckgo.com)
)中的URL 。
My favorite search engine is [Duck Duck Go](https://duckduckgo.com).
呈現(xiàn)的輸出如下所示:
我最喜歡的搜索引擎是Duck Duck Go。
添加標題
您可以選擇為鏈接添加標題。當用戶將鼠標懸停在鏈接上時,這將顯示為工具提示。要添加標題,請將其括在URL后面的括號中。
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)換為鏈接,請將其括在尖括號中。
<https://markdown.p2hp.com> <fake@example.com>
呈現(xiàn)的輸出如下所示:
https://markdown.p2hp.com
fake@example.com
格式化鏈接
為了強調(dià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)的部分以及在文件中其他位置存儲的部分,以使文本易于閱讀。
格式化鏈接的第一部分
參考樣式鏈接的第一部分使用兩組括號進行格式化。第一組方括號包圍應(yīng)顯示為鏈接的文本。第二組括號顯示了一個標簽,該標簽用于指向您存儲在文檔其他位置的鏈接。
盡管不是必需的,但您可以在第一組和第二組支架之間包含一個空格。第二組括號中的標簽不區(qū)分大小寫,可以包含字母,數(shù)字,空格或標點符號。
這意味著以下示例格式對于鏈接的第一部分大致相同:
[hobbit-hole][1]
[hobbit-hole] [1]
格式化鏈接的第二部分
引用樣式鏈接的第二部分使用以下屬性設(shè)置格式:
- 標簽放在方括號中,后緊跟冒號和至少一個空格(例如
[label]:
)。 - 鏈接的URL,您可以選擇將其括在尖括號中。
- 鏈接的可選標題,您可以將其括在雙引號,單引號或括號中。
這意味著以下示例格式對于鏈接的第二部分幾乎都是等效的:
[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è)您添加一個URL作為到段落的標準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確實不會給現(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)的輸出將相同:
在地上的一個洞里住著一個霍比特人。這不是一個骯臟,骯臟,潮濕的洞,里面充滿蠕蟲的末端和難聞的氣味,也沒有一個干燥,裸露,沙質(zhì)的洞,里面沒有東西可以坐下或進食:那是一個霍比特洞,意味著舒適。
鏈接HTML為:
<a rel="external nofollow" title="Hobbit lifestyles">hobbit-hole</a>
圖片
要添加圖像,請?zhí)砑痈袊@號(!
),然后在括號中添加替代文本,并在括號中添加圖像資源的路徑或URL。您可以選擇在括號中的URL之后添加標題。

呈現(xiàn)的輸出如下所示:
鏈接圖像
要向圖像添加鏈接,請將圖像的Markdown括在方括號中,然后在括號中添加鏈接。
[](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文檔中的文本格式\
,請在字符前面添加反斜杠()。
\* Without the backslash, this would be a bullet in an unordered list.
呈現(xiàn)的輸出如下所示:
*如果沒有反斜杠,這將是無序列表中的項目符號。
你可以轉(zhuǎn)義的字符
您可以使用反斜杠轉(zhuǎn)義以下字符。
字符 | 名稱 |
---|---|
\ | 反斜杠 |
` | 刻度線 |
* | 星號 |
_ | 下劃線 |
{} | 大括號 |
[] | 中括號 |
() | 括號 |
# | 井號 |
+ | 加號 |
- | 減號(連字符) |
. | 點 |
! | 感嘆號 |
| | 管道 |
相關(guān)文章
鴻蒙UI開發(fā)之滾動組件overscroll-decor安裝和使用介紹
鴻蒙UI開發(fā)之滾動組件overscroll-decor?是一個開源庫,提供一種簡單、靈活的方式來實現(xiàn)各種過度滾動(overscroll)動畫效果,提升用戶的交互體驗,該庫提供了類似于iOS的過度滾動效果,幾乎可以應(yīng)用于所有Android,如RecyclerView、ListView、GridView、ScrollView等?2024-12-12http請求405錯誤方法不被允許的解決 (Method not allowed)
這篇文章主要介紹了http請求405錯誤方法不被允許的解決 (Method not allowed),文中通過示例代碼介紹的非常詳細,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(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ū)版本庫暫存區(qū)的關(guān)系
這篇文章主要為大家介紹了Git的基本操作流程及工作區(qū)版本庫暫存區(qū)的關(guān)系,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2022-04-04如何在本地部署DeepSeek大模型實現(xiàn)聯(lián)網(wǎng)增強的AI應(yīng)用
本文介紹了如何使用Microsoft?SemanticKernel框架結(jié)合DeepSeek本地模型和自定義搜索技能,構(gòu)建一個具備聯(lián)網(wǎng)增強能力的智能應(yīng)用,文章還提供了一個應(yīng)用場景示例,說明如何在本地部署DeepSeek大模型并實現(xiàn)聯(lián)網(wǎng)增強的AI應(yīng)用,感興趣的朋友一起看看吧2025-02-02