arkdown 基礎(chǔ)語(yǔ)法

概述

Markdown是一種輕量級(jí)標(biāo)記語(yǔ)言，排版語(yǔ)法簡(jiǎn)潔，讓人們更多地關(guān)注內(nèi)容本身而非排版。它使用易讀易寫(xiě)的純文本格式編寫(xiě)文檔，可與HTML混編，可導(dǎo)出 HTML、PDF 以及本身的 .md 格式的文件。因簡(jiǎn)潔、高效、易讀、易寫(xiě)，Markdown被大量使用，如Github、Wikipedia、簡(jiǎn)書(shū)等。 千萬(wàn)不要被「標(biāo)記」、「語(yǔ)言」嚇到，Markdown的語(yǔ)法十分簡(jiǎn)單，常用的標(biāo)記符號(hào)不超過(guò)十個(gè)，用于日常寫(xiě)作記錄綽綽有余，不到半小時(shí)就能完全掌握。 就是這十個(gè)不到的標(biāo)記符號(hào)，卻能讓人優(yōu)雅地沉浸式記錄，專(zhuān)注內(nèi)容而不是糾結(jié)排版，達(dá)到「心中無(wú)塵，碼字入神」的境界。

標(biāo)題語(yǔ)法

要?jiǎng)?chuàng)建標(biāo)題，請(qǐng)?jiān)趩卧~或短語(yǔ)前面添加井號(hào) (#) 。# 的數(shù)量代表了標(biāo)題的級(jí)別。例如，添加三個(gè) # 表示創(chuàng)建一個(gè)三級(jí)標(biāo)題 (<h3>) (例如：### My Header)。

可選語(yǔ)法

還可以在文本下方添加任意數(shù)量的 == 號(hào)來(lái)標(biāo)識(shí)一級(jí)標(biāo)題，或者 -- 號(hào)來(lái)標(biāo)識(shí)二級(jí)標(biāo)題。

不同的 Markdown 應(yīng)用程序處理 # 和標(biāo)題之間的空格方式并不一致。為了兼容考慮，請(qǐng)用一個(gè)空格在 # 和標(biāo)題之間進(jìn)行分隔。

段落語(yǔ)法

要?jiǎng)?chuàng)建段落，請(qǐng)使用空白行將一行或多行文本進(jìn)行分隔。

不要用空格（spaces）或制表符（ tabs）縮進(jìn)段落。

換行語(yǔ)法

在一行的末尾添加兩個(gè)或多個(gè)空格，然后按回車(chē)鍵,即可創(chuàng)建一個(gè)換行(<br>)。

換行最佳實(shí)踐

幾乎每個(gè) Markdown 應(yīng)用程序都支持兩個(gè)或多個(gè)空格進(jìn)行換行，稱(chēng)為 結(jié)尾空格（trailing whitespace) 的方式，但這是有爭(zhēng)議的，因?yàn)楹茈y在編輯器中直接看到空格，并且很多人在每個(gè)句子后面都會(huì)有意或無(wú)意地添加兩個(gè)空格。由于這個(gè)原因，你可能要使用除結(jié)尾空格以外的其它方式來(lái)?yè)Q行。幸運(yùn)的是，幾乎每個(gè) Markdown 應(yīng)用程序都支持另一種換行方式：HTML 的
標(biāo)簽。

為了兼容性，請(qǐng)?jiān)谛形蔡砑印敖Y(jié)尾空格”或 HTML 的
標(biāo)簽來(lái)實(shí)現(xiàn)換行。

還有兩種其他方式我并不推薦使用。CommonMark 和其它幾種輕量級(jí)標(biāo)記語(yǔ)言支持在行尾添加反斜杠 () 的方式實(shí)現(xiàn)換行，但是并非所有 Markdown 應(yīng)用程序都支持此種方式，因此從兼容性的角度來(lái)看，不推薦使用。并且至少有兩種輕量級(jí)標(biāo)記語(yǔ)言支持無(wú)須在行尾添加任何內(nèi)容，只須鍵入回車(chē)鍵（return）即可實(shí)現(xiàn)換行。

強(qiáng)調(diào)語(yǔ)法

通過(guò)將文本設(shè)置為粗體或斜體來(lái)強(qiáng)調(diào)其重要性。

粗體（Bold）

要加粗文本，請(qǐng)?jiān)趩卧~或短語(yǔ)的前后各添加兩個(gè)星號(hào)（asterisks）或下劃線（underscores）。如需加粗一個(gè)單詞或短語(yǔ)的中間部分用以表示強(qiáng)調(diào)的話，請(qǐng)?jiān)谝哟植糠值膬蓚?cè)各添加兩個(gè)星號(hào)（asterisks）。

粗體（Bold）用法最佳實(shí)踐 Markdown 應(yīng)用程序在如何處理單詞或短語(yǔ)中間的下劃線上并不一致。為兼容考慮，在單詞或短語(yǔ)中間部分加粗的話，請(qǐng)使用星號(hào)（*）。

斜體（Italic）

要用斜體顯示文本，請(qǐng)?jiān)趩卧~或短語(yǔ)前后添加一個(gè)星號(hào)（*）或下劃線（_）。要斜體突出單詞的中間部分，請(qǐng)?jiān)谧帜盖昂蟾魈砑右粋€(gè)星號(hào)，中間不要帶空格。

斜體（Italic）用法的最佳實(shí)踐 要同時(shí)用粗體和斜體突出顯示文本，請(qǐng)?jiān)趩卧~或短語(yǔ)的前后各添加三個(gè)星號(hào)或下劃線。要加粗并用斜體顯示單詞或短語(yǔ)的中間部分，請(qǐng)?jiān)谝怀鲲@示的部分前后各添加三個(gè)星號(hào)，中間不要帶空格。

粗體（Bold）和斜體（Italic）

要同時(shí)用粗體和斜體突出顯示文本，請(qǐng)?jiān)趩卧~或短語(yǔ)的前后各添加三個(gè)星號(hào)或下劃線。要加粗并用斜體顯示單詞或短語(yǔ)的中間部分，請(qǐng)?jiān)谝怀鲲@示的部分前后各添加三個(gè)星號(hào)，中間不要帶空格。

粗體（Bold）和斜體（Italic）用法的最佳實(shí)踐

Markdown 應(yīng)用程序在處理單詞或短語(yǔ)中間添加的下劃線上并不一致。為了實(shí)現(xiàn)兼容性，請(qǐng)使用星號(hào)將單詞或短語(yǔ)的中間部分加粗并以斜體顯示，以示重要。

引用語(yǔ)法

要?jiǎng)?chuàng)建塊引用，請(qǐng)?jiān)诙温淝疤砑右粋€(gè) > 符號(hào)。

> Dorothy followed her through many of the beautiful rooms in her castle.

渲染效果如下所示：

Dorothy followed her through many of the beautiful rooms in her castle.

多個(gè)段落的塊引用

塊引用可以包含多個(gè)段落。為段落之間的空白行添加一個(gè) > 符號(hào)。

> 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.

渲染效果如下：

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.

嵌套塊引用

塊引用可以嵌套。在要嵌套的段落前添加一個(gè) >> 符號(hào)。

> 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.

渲染效果如下：

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.

帶有其它元素的塊引用

塊引用可以包含其他 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**.

渲染效果如下：

The quarterly results look great!Revenue was off the chart.Profits were higher than ever.

Everything is going according to plan.

列表語(yǔ)法

可以將多個(gè)條目組織成有序或無(wú)序列表。

有序列表

要?jiǎng)?chuàng)建有序列表，請(qǐng)?jiān)诿總€(gè)列表項(xiàng)前添加數(shù)字并緊跟一個(gè)英文句點(diǎn)。數(shù)字不必按數(shù)學(xué)順序排列，但是列表應(yīng)當(dāng)以數(shù)字 1 起始。

無(wú)序列表

要?jiǎng)?chuàng)建無(wú)序列表，請(qǐng)?jiān)诿總€(gè)列表項(xiàng)前面添加破折號(hào) (-)、星號(hào) (*) 或加號(hào) (+) ?？s進(jìn)一個(gè)或多個(gè)列表項(xiàng)可創(chuàng)建嵌套列表。

在列表中嵌套其他元素

要在保留列表連續(xù)性的同時(shí)在列表中添加另一種元素，請(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.

渲染效果如下：

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.

引用塊

*   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.

渲染效果如下：

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.

代碼塊

代碼塊通常采用四個(gè)空格或一個(gè)制表符縮進(jìn)。當(dāng)它們被放在列表中時(shí)，請(qǐng)將它們縮進(jìn)八個(gè)空格或兩個(gè)制表符。

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.

渲染效果如下：

Open the file.

Find the following code block on line 21:

Update the title to match the name of your website.

圖片

1.  Open the file containing the Linux mascot.
2.  Marvel at its beauty.

    ![百度](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)

3.  Close the file.

渲染效果如下：

Open the file containing the Linux mascot.

Marvel at its beauty.

Close the file.

代碼語(yǔ)法

要將單詞或短語(yǔ)表示為代碼，請(qǐng)將其包裹在反引號(hào) (`) 中。

轉(zhuǎn)義反引號(hào)

如果你要表示為代碼的單詞或短語(yǔ)中包含一個(gè)或多個(gè)反引號(hào)，則可以通過(guò)將單詞或短語(yǔ)包裹在雙反引號(hào)(``)中。

代碼塊

要?jiǎng)?chuàng)建代碼塊，請(qǐng)將代碼塊的每一行縮進(jìn)至少四個(gè)空格或一個(gè)制表符。

     <html>
          <head>
          </head>
    </html>

渲染效果如下：

 <html>
      <head>
      </head>
</html>

Note: 要?jiǎng)?chuàng)建不用縮進(jìn)的代碼塊，請(qǐng)使用 圍欄式代碼塊

分割線語(yǔ)法

要?jiǎng)?chuàng)建分隔線，請(qǐng)?jiān)趩为?dú)一行上使用三個(gè)或多個(gè)星號(hào) (***)、破折號(hào) (---) 或下劃線 (___) ，并且不能包含其他內(nèi)容。

***

---

_________________

以上三個(gè)分隔線的渲染效果看起來(lái)都一樣：

為了兼容性，請(qǐng)?jiān)诜指艟€的前后均添加空白行。

鏈接語(yǔ)法

鏈接文本放在中括號(hào)內(nèi)，鏈接地址放在后面的括號(hào)中，鏈接title可選。

超鏈接Markdown語(yǔ)法代碼：[超鏈接顯示名](超鏈接地址 "超鏈接title")

對(duì)應(yīng)的HTML代碼：<a href="超鏈接地址" title="超鏈接title">超鏈接顯示名</a>

這是一個(gè)鏈接 [Markdown語(yǔ)法](https://www.example.com)。

渲染效果如下：

這是一個(gè)鏈接 Markdown語(yǔ)法。

給鏈接增加 Title

鏈接title是當(dāng)鼠標(biāo)懸停在鏈接上時(shí)會(huì)出現(xiàn)的文字，這個(gè)title是可選的，它放在圓括號(hào)中鏈接地址后面，跟鏈接地址之間以空格分隔。

這是一個(gè)鏈接 [Markdown語(yǔ)法](https://www.example.com "最好的markdown教程")。

渲染效果如下： 這是一個(gè)鏈接 Markdown語(yǔ)法。

網(wǎng)址和Email地址

使用尖括號(hào)可以很方便地把URL或者email地址變成可點(diǎn)擊的鏈接。

<https://www.example.com>
<fake@example.com>

渲染效果如下： https://www.example.com fake@example.com

帶格式化的鏈接

強(qiáng)調(diào) 鏈接, 在鏈接語(yǔ)法前后增加星號(hào)。 要將鏈接表示為代碼，請(qǐng)?jiān)诜嚼ㄌ?hào)中添加反引號(hào)。

I love supporting the **[EFF](https://eff.org)**.
This is the *[Markdown Guide](https://www.example.com)*.
See the section on [`code`](#code).

渲染效果如下： I love supporting the EFF. This is the Markdown Guide. See the section on code.

引用類(lèi)型鏈接

引用樣式鏈接是一種特殊的鏈接，它使URL在Markdown中更易于顯示和閱讀。參考樣式鏈接分為兩部分：與文本保持內(nèi)聯(lián)的部分以及存儲(chǔ)在文件中其他位置的部分，以使文本易于閱讀。

鏈接的第一部分格式

引用類(lèi)型的鏈接的第一部分使用兩組括號(hào)進(jìn)行格式設(shè)置。第一組方括號(hào)包圍應(yīng)顯示為鏈接的文本。第二組括號(hào)顯示了一個(gè)標(biāo)簽，該標(biāo)簽用于指向您存儲(chǔ)在文檔其他位置的鏈接。

盡管不是必需的，可以在第一組和第二組括號(hào)之間包含一個(gè)空格。第二組括號(hào)中的標(biāo)簽不區(qū)分大小寫(xiě)，可以包含字母，數(shù)字，空格或標(biāo)點(diǎn)符號(hào)。

以下示例格式對(duì)于鏈接的第一部分效果相同：

• [hobbit-hole][1]
• [hobbit-hole] [1]

鏈接的第二部分格式

引用類(lèi)型鏈接的第二部分使用以下屬性設(shè)置格式：

放在括號(hào)中的標(biāo)簽，其后緊跟一個(gè)冒號(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)的段落之后，有些人則將它們放在文檔的末尾（例如尾注或腳注）。

不同的 Markdown 應(yīng)用程序處理URL中間的空格方式不一樣。為了兼容性，請(qǐng)盡量使用%20代替空格。

圖片語(yǔ)法

要添加圖像，請(qǐng)使用感嘆號(hào) (!), 然后在方括號(hào)增加替代文本，圖片鏈接放在圓括號(hào)里，括號(hào)里的鏈接后可以增加一個(gè)可選的圖片標(biāo)題文本。

插入圖片Markdown語(yǔ)法代碼：。

對(duì)應(yīng)的HTML代碼：<img src="圖片鏈接" alt="圖片alt" title="圖片title">

![這是圖片](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png "百度")

渲染效果如下：

鏈接圖片

給圖片增加鏈接，請(qǐng)將圖像的Markdown 括在方括號(hào)中，然后將鏈接添加在圓括號(hào)中。

[![百度圖片](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png "百度")](https://www.baidu.com)

渲染效果如下：

轉(zhuǎn)義字符語(yǔ)法

要顯示原本用于格式化 Markdown 文檔的字符，請(qǐng)?jiān)谧址懊嫣砑臃葱备茏址?\ 。

\* Without the backslash, this would be a bullet in an unordered list.

渲染效果如下：

* Without the backslash, this would be a bullet in an unordered list.

可做轉(zhuǎn)義的字符

以下列出的字符都可以通過(guò)使用反斜杠字符從而達(dá)到轉(zhuǎn)義目的。

特殊字符自動(dòng)轉(zhuǎn)義

在 HTML 文件中，有兩個(gè)字符需要特殊處理： < 和 & 。 < 符號(hào)用于起始標(biāo)簽，& 符號(hào)則用于標(biāo)記 HTML 實(shí)體，如果你只是想要使用這些符號(hào)，你必須要使用實(shí)體的形式，像是 < 和 &。

& 符號(hào)其實(shí)很容易讓寫(xiě)作網(wǎng)頁(yè)文件的人感到困擾，如果你要打「AT&T」 ，你必須要寫(xiě)成「AT&T」 ，還得轉(zhuǎn)換網(wǎng)址內(nèi)的 & 符號(hào)，如果你要鏈接到：

http://images.google.com/images?num=30&q=larry+bird

你必須要把網(wǎng)址轉(zhuǎn)成：

http://images.google.com/images?num=30&q=larry+bird

才能放到鏈接標(biāo)簽的 href 屬性里。不用說(shuō)也知道這很容易忘記，這也可能是 HTML 標(biāo)準(zhǔn)檢查所檢查到的錯(cuò)誤中，數(shù)量最多的。

Markdown 允許你直接使用這些符號(hào)，它幫你自動(dòng)轉(zhuǎn)義字符。如果你使用 & 符號(hào)的作為 HTML 實(shí)體的一部分，那么它不會(huì)被轉(zhuǎn)換，而在其它情況下，它則會(huì)被轉(zhuǎn)換成 &。所以你如果要在文件中插入一個(gè)著作權(quán)的符號(hào)，你可以這樣寫(xiě)：

?

Markdown 將不會(huì)對(duì)這段文字做修改，但是如果你這樣寫(xiě)：

AT&T

Markdown 就會(huì)將它轉(zhuǎn)為：

AT&T

類(lèi)似的狀況也會(huì)發(fā)生在 < 符號(hào)上，因?yàn)?Markdown 支持 行內(nèi) HTML ，如果你使用 < 符號(hào)作為 HTML 標(biāo)簽的分隔符，那 Markdown 也不會(huì)對(duì)它做任何轉(zhuǎn)換，但是如果你是寫(xiě)：

4 < 5

Markdown 將會(huì)把它轉(zhuǎn)換為：

4 < 5

需要特別注意的是，在 Markdown 的塊級(jí)元素和內(nèi)聯(lián)元素中， < 和 & 兩個(gè)符號(hào)都會(huì)被自動(dòng)轉(zhuǎn)換成 HTML 實(shí)體，這項(xiàng)特性讓你可以很容易地用 Markdown 寫(xiě) HTML。（在 HTML 語(yǔ)法中，你要手動(dòng)把所有的 < 和 & 都轉(zhuǎn)換為 HTML 實(shí)體。）

內(nèi)嵌HTML標(biāo)簽

對(duì)于 Markdown 涵蓋范圍之外的標(biāo)簽，都可以直接在文件里面用 HTML 本身。如需使用 HTML，不需要額外標(biāo)注這是 HTML 或是 Markdown，只需 HTML 標(biāo)簽添加到 Markdown 文本中即可。

行級(jí)內(nèi)聯(lián)標(biāo)簽

HTML 的行級(jí)內(nèi)聯(lián)標(biāo)簽如 <span>、<cite>、<del> 不受限制，可以在 Markdown 的段落、列表或是標(biāo)題里任意使用。依照個(gè)人習(xí)慣，甚至可以不用 Markdown 格式，而采用 HTML 標(biāo)簽來(lái)格式化。例如：如果比較喜歡 HTML 的 <a> 或 <img> 標(biāo)簽，可以直接使用這些標(biāo)簽，而不用 Markdown 提供的鏈接或是圖片語(yǔ)法。當(dāng)你需要更改元素的屬性時(shí)（例如為文本指定顏色或更改圖像的寬度），使用 HTML 標(biāo)簽更方便些。

HTML 行級(jí)內(nèi)聯(lián)標(biāo)簽和區(qū)塊標(biāo)簽不同，在內(nèi)聯(lián)標(biāo)簽的范圍內(nèi)， Markdown 的語(yǔ)法是可以解析的。

This **word** is bold. This <em>word</em> is italic.

渲染效果如下： This word is bold. This word is italic.

區(qū)塊標(biāo)簽

區(qū)塊元素──比如 <div>、<table>、<pre>、<p> 等標(biāo)簽，必須在前后加上空行，以便于內(nèi)容區(qū)分。而且這些元素的開(kāi)始與結(jié)尾標(biāo)簽，不可以用 tab 或是空白來(lái)縮進(jìn)。Markdown 會(huì)自動(dòng)識(shí)別這區(qū)塊元素，避免在區(qū)塊標(biāo)簽前后加上沒(méi)有必要的

標(biāo)簽。

例如，在 Markdown 文件里加上一段 HTML 表格：

This is a regular paragraph.

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

This is another regular paragraph.

請(qǐng)注意，Markdown 語(yǔ)法在 HTML 區(qū)塊標(biāo)簽中將不會(huì)被進(jìn)行處理。例如，你無(wú)法在 HTML 區(qū)塊內(nèi)使用 Markdown 形式的*強(qiáng)調(diào)*。

提示：出于安全原因，并非所有 Markdown 應(yīng)用程序都支持在 Markdown 文檔中添加 HTML。如有疑問(wèn)，請(qǐng)查看相應(yīng) Markdown 應(yīng)用程序的手冊(cè)。某些應(yīng)用程序只支持 HTML 標(biāo)簽的子集。

對(duì)于 HTML 的塊級(jí)元素 <div>、<table>、<pre> 和 <p>，請(qǐng)?jiān)谄淝昂笫褂每招校╞lank lines）與其它內(nèi)容進(jìn)行分隔。盡量不要使用制表符（tabs）或空格（spaces）對(duì) HTML 標(biāo)簽做縮進(jìn)，否則將影響格式。

在 HTML 塊級(jí)標(biāo)簽內(nèi)不能使用 Markdown 語(yǔ)法。例如 <p>italic and **bold**</p> 將不起作用。

擴(kuò)展語(yǔ)法

原始設(shè)計(jì)文檔中概述的基本語(yǔ)法主要是為了應(yīng)付大多數(shù)情況下的日常所需元素，但對(duì)于某些人來(lái)說(shuō)還不夠，這就是擴(kuò)展語(yǔ)法的用武之地。

一些個(gè)人和組織開(kāi)始通過(guò)添加其他元素（例如表，代碼塊，語(yǔ)法突出顯示，URL自動(dòng)鏈接和腳注）來(lái)擴(kuò)展基本語(yǔ)法。可以通過(guò)使用基于基本Markdown語(yǔ)法的輕量級(jí)標(biāo)記語(yǔ)言，或通過(guò)向兼容的Markdown處理器添加擴(kuò)展來(lái)啟用這些元素。

表格

要添加表，請(qǐng)使用三個(gè)或多個(gè)連字符（---）創(chuàng)建每列的標(biāo)題，并使用管道（|）分隔每列。您可以選擇在表的任一端添加管道。

| 語(yǔ)法 | 描述 |
| ---- | ---- |
| 頭部 | 標(biāo)題 |
| 段落 | 文本 |

呈現(xiàn)的輸出如下所示：

單元格寬度可以變化，如下所示。呈現(xiàn)的輸出將看起來(lái)相同。

| 語(yǔ)法 | 描述 |
| ---| ------ |
| 頭部 | 標(biāo)題 |
| 段落 | 文本 |

Tip: 使用連字符和管道創(chuàng)建表可能很麻煩。 #### 對(duì)齊

您可以通過(guò)在標(biāo)題行中的連字符的左側(cè)，右側(cè)或兩側(cè)添加冒號(hào)（:），將列中的文本對(duì)齊到左側(cè)，右側(cè)或中心。

| 語(yǔ)法      | 描述 | 測(cè)試文本     |
| :---        |    :----:   |          ---: |
| 頭部      | 標(biāo)題       | 你好   |
| 段落   | 文本        | 更好      |

呈現(xiàn)的輸出如下所示：

格式化表格中的文字

您可以在表格中設(shè)置文本格式。例如，您可以添加鏈接，代碼（僅反引號(hào)（`）中的單詞或短語(yǔ)，而不是代碼塊）和強(qiáng)調(diào)。

您不能添加標(biāo)題，塊引用，列表，水平規(guī)則，圖像或HTML標(biāo)簽。

在表中轉(zhuǎn)義管道字符

您可以使用表格的HTML字符代碼（|）在表中顯示豎線（|）字符。

圍欄代碼塊

Markdown基本語(yǔ)法允許您通過(guò)將行縮進(jìn)四個(gè)空格或一個(gè)制表符來(lái)創(chuàng)建代碼塊。如果發(fā)現(xiàn)不方便，請(qǐng)嘗試使用受保護(hù)的代碼塊。根據(jù)Markdown處理器或編輯器的不同，您將在代碼塊之前和之后的行上使用三個(gè)反引號(hào)（(```）或三個(gè)波浪號(hào)（~~~）。

```
{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}
```

呈現(xiàn)的輸出如下所示：

{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}

語(yǔ)法高亮

許多Markdown處理器都支持受?chē)鷻诖a塊的語(yǔ)法突出顯示。使用此功能，您可以為編寫(xiě)代碼的任何語(yǔ)言添加顏色突出顯示。要添加語(yǔ)法突出顯示，請(qǐng)?jiān)谑芊雷o(hù)的代碼塊之前的反引號(hào)旁邊指定一種語(yǔ)言。

```json
{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}
```

呈現(xiàn)的輸出如下所示：

{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}

腳注

腳注使您可以添加注釋和參考，而不會(huì)使文檔正文混亂。當(dāng)您創(chuàng)建腳注時(shí)，帶有腳注的上標(biāo)數(shù)字會(huì)出現(xiàn)在您添加腳注參考的位置。讀者可以單擊鏈接以跳至頁(yè)面底部的腳注內(nèi)容。

要?jiǎng)?chuàng)建腳注參考，請(qǐng)?jiān)诜嚼ㄌ?hào)（[^1]）內(nèi)添加插入符號(hào)和標(biāo)識(shí)符。標(biāo)識(shí)符可以是數(shù)字或單詞，但不能包含空格或制表符。標(biāo)識(shí)符僅將腳注參考與腳注本身相關(guān)聯(lián)-在輸出中，腳注按順序編號(hào)。

在括號(hào)內(nèi)使用另一個(gè)插入符號(hào)和數(shù)字添加腳注，并用冒號(hào)和文本（[^1]: My footnote.）。您不必在文檔末尾添加腳注。您可以將它們放在除列表，塊引號(hào)和表之類(lèi)的其他元素之外的任何位置。

Here's a simple footnote,[^1] and here's a longer one.[^bignote]

[^1]: This is the first footnote.

[^bignote]: Here's one with multiple paragraphs and code.

    Indent paragraphs to include them in the footnote.

    `{ my code }`

    Add as many paragraphs as you like.

呈現(xiàn)的輸出如下所示：

Here's a simple footnote,[^1] and here's a longer one.[^bignote]

[^1]: This is the first footnote.

[^bignote]: Here's one with multiple paragraphs and code.

Indent paragraphs to include them in the footnote.

`{ my code }`

Add as many paragraphs as you like.

標(biāo)題編號(hào)

許多Markdown處理器支持標(biāo)題的自定義ID - 一些Markdown處理器會(huì)自動(dòng)添加它們。添加自定義ID允許您直接鏈接到標(biāo)題并使用CSS對(duì)其進(jìn)行修改。要添加自定義標(biāo)題ID，請(qǐng)?jiān)谂c標(biāo)題相同的行上用大括號(hào)括起該自定義ID。

### My Great Heading {#custom-id}

HTML看起來(lái)像這樣：

<h3 id="custom-id">My Great Heading</h3>

鏈接到標(biāo)題ID (#headid)

通過(guò)創(chuàng)建帶有數(shù)字符號(hào)（#）和自定義標(biāo)題ID的標(biāo)準(zhǔn)鏈接，可以鏈接到文件中具有自定義ID的標(biāo)題。

其他網(wǎng)站可以通過(guò)將自定義標(biāo)題ID添加到網(wǎng)頁(yè)的完整URL（例如[Heading IDs](https://www.example.com/heading-ids.html#headid)）來(lái)鏈接到標(biāo)題。

定義列表

一些Markdown處理器允許您創(chuàng)建術(shù)語(yǔ)及其對(duì)應(yīng)定義的定義列表。要?jiǎng)?chuàng)建定義列表，請(qǐng)?jiān)诘谝恍猩湘I入術(shù)語(yǔ)。在下一行，鍵入一個(gè)冒號(hào)，后跟一個(gè)空格和定義。

First Term
: This is the definition of the first term.

Second Term
: This is one definition of the second term.
: This is another definition of the second term.

HTML看起來(lái)像這樣：

<dl>
  <dt>First Term</dt>
  <dd>This is the definition of the first term.</dd>
  <dt>Second Term</dt>
  <dd>This is one definition of the second term. </dd>
  <dd>This is another definition of the second term.</dd>
</dl>

呈現(xiàn)的輸出如下所示：

First Term

This is the definition of the first term.

Second Term

This is one definition of the second term. This is another definition of the second term.

刪除線

您可以通過(guò)在單詞中心放置一條水平線來(lái)刪除單詞。結(jié)果看起來(lái)像這樣。此功能使您可以指示某些單詞是一個(gè)錯(cuò)誤，要從文檔中刪除。若要?jiǎng)h除單詞，請(qǐng)?jiān)趩卧~前后使用兩個(gè)波浪號(hào)~~。

~~2023年很卷~~ ，希望2024世界更加美好。

呈現(xiàn)的輸出如下所示：

2023年很卷 ，希望2024世界更加美好。

任務(wù)列表語(yǔ)法

任務(wù)列表使您可以創(chuàng)建帶有復(fù)選框的項(xiàng)目列表。在支持任務(wù)列表的Markdown應(yīng)用程序中，復(fù)選框?qū)@示在內(nèi)容旁邊。要?jiǎng)?chuàng)建任務(wù)列表，請(qǐng)?jiān)谌蝿?wù)列表項(xiàng)之前添加破折號(hào)-和方括號(hào)[ ]，并在[ ]前面加上空格。要選擇一個(gè)復(fù)選框，請(qǐng)?jiān)诜嚼ㄌ?hào)[x]之間添加 x 。 示例代碼：

- [x] 列表1
- [ ] 列表2
- [ ] 列表3

呈現(xiàn)的輸出如下所示：

• 列表1
• 列表2
• 列表3

使用Emoji表情

有兩種方法可以將表情符號(hào)添加到Markdown文件中：將表情符號(hào)復(fù)制并粘貼到Markdown格式的文本中，或者鍵入emoji shortcodes。

復(fù)制和粘貼表情符號(hào)

在大多數(shù)情況下，您可以簡(jiǎn)單地從Emojipedia 等來(lái)源復(fù)制表情符號(hào)并將其粘貼到文檔中。許多Markdown應(yīng)用程序會(huì)自動(dòng)以Markdown格式的文本顯示表情符號(hào)。從Markdown應(yīng)用程序?qū)С龅腍TML和PDF文件應(yīng)顯示表情符號(hào)。

Tip: 如果您使用的是靜態(tài)網(wǎng)站生成器，請(qǐng)確保將HTML頁(yè)面編碼為UTF-8。

使用表情符號(hào)簡(jiǎn)碼

一些Markdown應(yīng)用程序允許您通過(guò)鍵入表情符號(hào)短代碼來(lái)插入表情符號(hào)。這些以冒號(hào)開(kāi)頭和結(jié)尾，并包含表情符號(hào)的名稱(chēng)。

歡迎閱讀此文 :tent: 如對(duì)你有幫助，動(dòng)動(dòng)小手指點(diǎn)個(gè)贊吧，給博主一點(diǎn)鼓勵(lì) :heart: 。

哈哈哈！   

呈現(xiàn)的輸出如下所示：

歡迎閱讀此文 :tent: 如對(duì)你有幫助，動(dòng)動(dòng)小手指點(diǎn)個(gè)贊吧，給博主一點(diǎn)鼓勵(lì) :heart: 。

哈哈哈！

Note: 注意：您可以使用此表情符號(hào)簡(jiǎn)碼列表，但請(qǐng)記住，表情符號(hào)簡(jiǎn)碼因應(yīng)用程序而異。 多個(gè)單詞的簡(jiǎn)碼用 _ 來(lái)連接，且簡(jiǎn)碼必須是小寫(xiě)。

自動(dòng)網(wǎng)址鏈接

許多Markdown處理器會(huì)自動(dòng)將URL轉(zhuǎn)換為鏈接。這意味著如果您輸入http://www.example.com，即使您未使用方括號(hào)(`[]`)，您的Markdown處理器也會(huì)自動(dòng)將其轉(zhuǎn)換為鏈接。

呈現(xiàn)的輸出如下所示：

http://www.example.com

禁用自動(dòng)URL鏈接

如果您不希望自動(dòng)鏈接URL，則可以通過(guò)將URL表示為帶反引號(hào)的代碼來(lái)刪除該鏈接。

`http://www.example.com`

呈現(xiàn)的輸出如下所示： http://www.example.com