Markdown怎么使用

這篇“Markdown怎么使用”文章的知識(shí)點(diǎn)大部分人都不太理解，所以小編給大家總結(jié)了以下內(nèi)容，內(nèi)容詳細(xì)，步驟清晰，具有一定的借鑒價(jià)值，希望大家閱讀完這篇文章能有所收獲，下面我們一起來(lái)看看這篇“Markdown怎么使用”文章吧。

創(chuàng)新互聯(lián)是一家專注網(wǎng)站建設(shè)、網(wǎng)絡(luò)營(yíng)銷策劃、微信小程序開(kāi)發(fā)、電子商務(wù)建設(shè)、網(wǎng)絡(luò)推廣、移動(dòng)互聯(lián)開(kāi)發(fā)、研究、服務(wù)為一體的技術(shù)型公司。公司成立十多年以來(lái)，已經(jīng)為上千家塔吊租賃各業(yè)的企業(yè)公司提供互聯(lián)網(wǎng)服務(wù)。現(xiàn)在，服務(wù)的上千家客戶與我們一路同行，見(jiàn)證我們的成長(zhǎng)；未來(lái)，我們一起分享成功的喜悅。

HTML 以  結(jié)尾的閉包定義注釋（支持跨行），不在正文中顯示。
Markdown 沿用 HTML Comment 注釋格式：


注釋適用場(chǎng)景示例：

CSDN 博客默認(rèn)會(huì)在網(wǎng)頁(yè)生成TOC，而 GitHub 仍不支持[TOC]，因此在發(fā)布 Markdown 博客時(shí)可注釋掉開(kāi)頭的 [TOC] 標(biāo)簽，在需要查看 OUTLINE 時(shí)再打開(kāi)。

在博客 Markdown 源碼開(kāi)頭，本人通常使用注釋來(lái)備注 git commit-hash-id 和 commit-date 信息（git log -p ），以便修訂變更時(shí)回溯。


在使用 Markdown 寫(xiě)作博客時(shí)，本人喜歡采用參考式鏈接，然后在文末專門(mén)開(kāi)辟一節(jié)用于定義文中用到的所有腳注和參考鏈接。借助 Haroopad/FoldingText/Marked2 的折疊特性，本人習(xí)慣在末尾添加一行 Comment Heading，用于在閱讀 Markdown 源碼時(shí)折疊隱藏文末的參考區(qū)。
##

標(biāo)題（Header）1

標(biāo)題用于呈現(xiàn)文檔組織結(jié)構(gòu)，很多 Markdown 解析器都提供基于 Heading Levels 來(lái)生成文檔大綱的 [TOC]（Table of Contents）標(biāo)簽，搜索引擎則使用標(biāo)題為網(wǎng)頁(yè)的結(jié)構(gòu)和內(nèi)容編制索引。

Markdown 支持兩種標(biāo)題的語(yǔ)法，類 Setext 和類 atx 形式。

Setext Heading Format（2 level）

類 Setext 形式是用底線的形式，使用三個(gè)或以上連續(xù) =（equal signs）底線標(biāo)記最高階標(biāo)題，使用三個(gè)或以上連續(xù) -（dashes）底線標(biāo)記第二階標(biāo)題。例如：

equal signs for first-level headers:

    This is an H1    ===12

dashes for second-level headers:

    This is an H2    ----12

Atx Heading Format（6 level）

類 Atx 形式則是在行首插入 1 到 6 個(gè) # （hash character），對(duì)應(yīng) 6 階標(biāo)題（對(duì)應(yīng) HTML 中的 <h2> - <h7> 標(biāo)簽）。例如：

# 這是一級(jí)標(biāo)題（H1，通常用于文檔標(biāo)題）  
## 這是二級(jí)標(biāo)題（H2，有些渲染器會(huì)為二級(jí)標(biāo)題添加 hr 底線）  
### 這是三級(jí)標(biāo)題（H3）  
#### 這是四級(jí)標(biāo)題（H4）  
##### 這是五級(jí)標(biāo)題（H5）#####  
###### 這是六級(jí)標(biāo)題（H6）######1234567

行首的 # 號(hào)個(gè)數(shù)決定標(biāo)題階數(shù)，為兼容和閱感起見(jiàn)，建議最后一個(gè) # 號(hào)和標(biāo)題文字之間加插一個(gè)空格。
行中（末）的 # 號(hào)則被視作普通字符。為美觀起見(jiàn)，你也可以選擇性地「閉合」類 atx 樣式的標(biāo)題，在行尾加上對(duì)應(yīng)或不限數(shù)量的 # 號(hào)。

句段（Sentence / Paragraph）

換行

標(biāo)準(zhǔn) Markdown 不支持自然換行（literal new line），有些渲染器擴(kuò)展支持自然換行。
# 號(hào)標(biāo)識(shí)的 Heading（H1-H6）會(huì)自然換行，普通句段之間若要強(qiáng)制換行（Manual Line Break），可以在自然換行行尾追加兩個(gè)（或以上）空格來(lái)實(shí)現(xiàn)。
由于不同的 Markdown Editor 的渲染效果不一，建議按照標(biāo)準(zhǔn) Markdown 書(shū)寫(xiě)，這樣發(fā)布到不同的渲染引擎下才能取得最優(yōu)的兼容性。例如：你可能需要在兩行連續(xù)的以 > 開(kāi)頭的引用之間加入兩個(gè)空格硬換行來(lái)避免粘連；在某些 Markdown Editor 中，你可能需要在 bullet list item 行尾追加兩個(gè)空格硬換行來(lái)續(xù)接后面的混合編排。

適時(shí)內(nèi)嵌 HTML 的   控制換行

由于空格在 Markdown 中主要是起著控制排版的作用，因此在某些復(fù)雜的區(qū)塊元素中，例如下文提到的 Table 表格中的 td 元素中，只能通過(guò)內(nèi)嵌 HTML 的 （XHTML 自閉合寫(xiě)作  ）標(biāo)簽來(lái)實(shí)現(xiàn)局部換行。

分段

段落是由一個(gè)或多個(gè)連續(xù)的文本行組成，它的前后往往需要空行予以明示分隔。

在顯示上看起來(lái)像是空的，例如只包含空格或（和）制表符（tab）的行，便會(huì)被視為空行。

空行適用場(chǎng)景說(shuō)明：

空行的上一句末無(wú)需再添加兩個(gè)空格或   換行了。
句段之間引入空行，相當(dāng)于間隔成段落（對(duì)應(yīng) HTML 的  標(biāo)簽）。
盡管 Markdown Render 會(huì)對(duì)各階 Heading（H1-H6）有特殊的格式渲染來(lái)凸顯層級(jí)，但還是建議在章節(jié)（Section/Chapter）末尾適時(shí)插入空行，以示行文分割且方便閱讀。
為了更優(yōu)的 閱讀感 和 兼容性，建議在分割線（Horizontal Rules）的上面留一空行，塊引用（Blockquote）、預(yù)格式化（Preformatted Code Block）、列表（List）、表格（Table）等區(qū)塊元素的上下各插入空行。

符號(hào)（Punctuation Characters）

轉(zhuǎn)義字符

Markdown 精挑細(xì)選了一些符號(hào)組成了一套基于文本的標(biāo)記語(yǔ)法。比如：

在文字兩旁加上 * 號(hào)，看起來(lái)就像*強(qiáng)調(diào)*。
多行行首添加 +（或 - 或 *），看起來(lái)就是列表。
句段行首添加 > 號(hào)來(lái)引用區(qū)塊，就像你曾在電子郵件中見(jiàn)過(guò)的那樣。

可以使用反斜杠（\，backslash）轉(zhuǎn)義輸入 Markdown 標(biāo)記符號(hào)的原義字符。

#：行首的 #（此處使用 kbd 閉包顯示按鍵字幕）號(hào)默認(rèn)為H1，這里使用反斜杠轉(zhuǎn)義顯示原義字符。

字符實(shí)體

在 Markdown 中，空格和 tab 往往用于格式控制，例如：

行首插入 tab 或四個(gè)空格縮進(jìn)表示 <pre> 預(yù)格式化；
引用、列表的 bullet 標(biāo)記符前的 tab 或空格用于縮進(jìn)嵌套層級(jí)；
…

普通段落一般都是頂格開(kāi)始，無(wú)法使用空格或 tab 來(lái)縮進(jìn)，包括引用標(biāo)記符（>）、列表標(biāo)記符（bullet list indicator）后面的空格都無(wú)法實(shí)現(xiàn)縮進(jìn)。
如果硬要輸入空格顯示占位縮進(jìn)效果，可以嵌入空格對(duì)應(yīng)的 HTML Entity 實(shí)體碼。HTML 轉(zhuǎn)義字符串（Escape Sequence），即字符實(shí)體（Character Entity）。字符實(shí)體由三部分構(gòu)成：

第一部分是一個(gè) & （ampersand）符號(hào)；
第二部分是實(shí)體（Entity）名字；或者 # 加上實(shí)體編號(hào)（ Entity Code ）；
第三部分是一個(gè)分號(hào) ; （semicolon）。

HTML提供了5種空格實(shí)體（ space entity ），它們擁有不同的寬度，非斷行空格（ ）是常規(guī)空格的寬度，可運(yùn)行于所有主流瀏覽器。其他幾種空格（ &ensp;、&emsp;、 、&zwnj;、&zwj;）在不同瀏覽器中寬度各異。

entity	code	full-name	width
` `	` `	no-break space	鍵盤(pán)空格（space bar）
`&ensp;`	` `	en space	半角空格（half-width）
`&emsp;`	` `	em space	全角空格（full-width）

1. 在HTML中，使用 產(chǎn)生的空格是不會(huì)累加的（只算1個(gè)）；要使用html實(shí)體表示才可累加。
2. &ensp;中的en是字體排印學(xué)的計(jì)量單位，為em寬度的一半，名義上是小寫(xiě)字母n的寬度。此空格傳承空格家族一貫的特性：透明的！此空格有個(gè)相當(dāng)穩(wěn)健的特性，就是其占據(jù)的寬度正好是1/2個(gè)中文寬度，而且基本上不受字體影響。
3. &emsp;中的em是字體排印學(xué)的計(jì)量單位，相當(dāng)于當(dāng)前指定的點(diǎn)數(shù)。此空格也傳承空格家族一貫的特性：透明的！此空格也有個(gè)相當(dāng)穩(wěn)健的特性，就是其占據(jù)的寬度正好是1個(gè)中文寬度，而且基本上不受字體影響。

普通自然行行首敲2個(gè)空格無(wú)占位縮進(jìn)效果。
該行行首添加了4個(gè) 。
????該行行首添加了4個(gè)&ensp;。
???該行行首添加了4個(gè)&emsp;。

分隔線（Horizontal Rules）

你可以在一行中用三個(gè)以上的星號(hào)（asterisks：*）或減號(hào)（hyphens：-）或底線（underscores：_）來(lái)建立一個(gè)水平分隔線，對(duì)應(yīng) HTML 中的 <hr> 標(biāo)簽，用于Sentence/Section/Page Break。
行內(nèi)不能有其他東西，但你可以在星號(hào)或是減號(hào)中間插入空格。
下面每種寫(xiě)法都可以建立起分隔線：

---
- - -
-----1234

注意：

采用減號(hào)（-）分割時(shí)，最好空格隔開(kāi)或上面空一行，不然三個(gè)以上連續(xù)的減號(hào)會(huì)誤將上一行文字升級(jí)為二級(jí)標(biāo)題！

文本格式（Text Styling）

文本格式包括強(qiáng)調(diào)、加粗、突出、下劃線、刪除線、腳標(biāo)等增強(qiáng)修飾和豐富表現(xiàn)。

強(qiáng)調(diào)（Italic/Emphasize）

說(shuō)明：
星號(hào)（*）或下劃線（_）包圍的文字將會(huì)顯示斜體，對(duì)應(yīng) HTML 中的  /  標(biāo)簽。

語(yǔ)法：

Some of these words *are emphasized*.
Some of these words _are emphasized also_.12

示例：
Some of these words are emphasized.
Some of these words are emphasized also.

GFM（ Github Flavored Markdown ）建議：

鑒于C語(yǔ)言等源碼中，通常采用下劃線定義變量，因此 GFM 忽略單詞內(nèi)的下劃線，同時(shí)建議使用星號(hào)（*）來(lái)包裹斜體。
下劃線閉包單詞斜體：wow great stuff (源碼：wow _great_ stuff)
GFM 忽略單詞內(nèi)的下劃線：wow_great_stuff

加粗（Bold/Strong）

說(shuō)明：
兩個(gè)星號(hào)（**）或下劃線（__）包圍的需要特別強(qiáng)調(diào)的文字將會(huì)加粗顯示，對(duì)應(yīng) HTML 中的  /  標(biāo)簽。

語(yǔ)法：

Use two asterisks for **strong emphasis**.
Or, if you prefer, __use two underscores instead__.
A ***section surrounded with three asterisks*** will be  specially emphasized.123

示例：
Use two asterisks for strong emphasis.
Or, if you prefer, use two underscores instead.
A section surrounded with three asterisks will be specially emphasized.

突出（Mark/Highlight）

說(shuō)明：
在 HTML 中，可以使用  標(biāo)簽來(lái)高亮顯示文字，以達(dá)到醒目的目的。
標(biāo)準(zhǔn) markdown 沒(méi)有提供對(duì)應(yīng)的標(biāo)簽支持，Macdown 和 Haroopad 均使用兩個(gè)等號(hào)（equal signs：=）包圍來(lái)突出高亮顯示。

語(yǔ)法：
Macdown 和 Haroopad：==Highlight==
CriticMarkup 語(yǔ)法：{==Highlight==}

示例：
Macdown 和 Haroopad：==Highlight==

下劃線（Underline）

說(shuō)明：
在 HTML 中，可以使用  標(biāo)簽來(lái)為文本添加下劃線。
標(biāo)準(zhǔn) markdown 沒(méi)有提供對(duì)應(yīng)的標(biāo)簽支持，MMD（ MultiMarkdown ）提供了擴(kuò)展支持。
Macdown 使用星號(hào)表示強(qiáng)調(diào)，使用下劃線表示下劃線原義；Haroopad 則使用兩個(gè)加號(hào)（plus sign：+）來(lái)標(biāo)記下劃線。

語(yǔ)法：
Macdown：_underline_
Haroopad：++underline++

示例：
Macdown：underline
Haroopad：++underline++

刪除線（Strikethrough）

說(shuō)明：
在 HTML 中，可以使用 <del> 標(biāo)簽來(lái)定義文檔中已被刪除的文本（配合 <ins> 標(biāo)簽來(lái)描述文檔中的更新和修正）。
標(biāo)準(zhǔn) markdown 沒(méi)有提供對(duì)應(yīng)的標(biāo)簽支持，GFM 提供了擴(kuò)展支持，使用兩個(gè)波浪符號(hào)（two wavy line:~~）包圍來(lái)給文本添加刪除線。

語(yǔ)法：

~~Strikethrough~~12

示例：
Strikethrough

腳標(biāo)（Script）

標(biāo)準(zhǔn) Markdown 不支持腳標(biāo)，只能通過(guò)內(nèi)嵌 HTML 的和標(biāo)簽來(lái)實(shí)現(xiàn)。

上腳標(biāo)：

Haroopad 語(yǔ)法（Caret）：^Superscript^
HTML 語(yǔ)法：superscript

示例：
2^10^ = 2¹⁰ = 1024;

下腳標(biāo)：

Haroopad 語(yǔ)法：~Subscript~
HTML 語(yǔ)法：subscript

示例：
H~2~O = H₂O is a liquid.

鏈接（Hyperlink）

自動(dòng)鏈接（Autolink）

當(dāng)我們?cè)跁?shū)寫(xiě)一個(gè)網(wǎng)址時(shí)，有些 Markdown Render 能自動(dòng)生成標(biāo)題（title）與網(wǎng)址（href URL）一致的鏈接，這種鏈接也即自動(dòng)鏈接。
Markdown 支持以比較簡(jiǎn)短的自動(dòng)鏈接形式來(lái)處理網(wǎng)址和電子郵件信箱，只要用尖括號(hào)包起來(lái)的文字， Markdown 就會(huì)自動(dòng)識(shí)別轉(zhuǎn)化成鏈接。
對(duì)于 HTTP(s) 協(xié)議開(kāi)頭的超鏈接地址，甚至無(wú)需添加尖括號(hào)明示，也會(huì)生成自動(dòng)鏈接。

http://daringfireball.net/projects/markdown/

文字（text href）

Markdown 支持兩種形式的超文本鏈接語(yǔ)法格式：行內(nèi)式（Inline）和參考式（Reference）兩種形式。
不管是哪一種，鏈接文字都是用方括號(hào)（square brackets：[]）來(lái)標(biāo)記。

行內(nèi)式（Inline）

只要在方塊括號(hào)后面緊接著圓括號(hào)（parenthesis or round brackets）并插入鏈接網(wǎng)址即可在一行內(nèi)構(gòu)建鏈接，其語(yǔ)法格式為[text](url)，HTML 等效源碼為 <a href="url">text</a>。
如果是要鏈接到本機(jī)資源，可以使用相對(duì)路徑（./path/to/your/resource）。

以下定義了一個(gè)指向 Daring Fireball Markdown 首頁(yè)的超鏈接：

[Daring Fireball Markdown](http://daringfireball.net/projects/markdown/)
Daring Fireball Markdown

如果你還想要加上鏈接的 title ，只要在網(wǎng)址后面用雙引號(hào)把 title 文字包起來(lái)即可。

[Daring Fireball Markdown](http://daringfireball.net/projects/markdown/ "Markdown Official Website")
Daring Fireball Markdown

當(dāng)鼠標(biāo)懸停在超鏈接文本上時(shí)，將會(huì)提示 “Markdown Official Website”。

參考式（Reference）

參考式的鏈接是在鏈接文字的括號(hào)后面再接上另一個(gè)方括號(hào)，在第二個(gè)方括號(hào)里面填入用以辨識(shí)鏈接的標(biāo)記id，然后在其他地方給出該標(biāo)記id真正的鏈接地址。

先定義參考refid：[text][refid]
再定義refid所指：[refid]:URL

以下參考間接定義指向 Daring Fireball Markdown 首頁(yè)的超鏈接：

先定義參考id為markdown_homepage_refid：
[Daring Fireball Markdown][markdown_homepage_refid]
再在其他地方定義markdown_homepage_refid指向的URL：
[markdown_homepage_refid]:http://daringfireball.net/projects/markdown/
最終效果同行內(nèi)式：
Daring Fireball Markdown

說(shuō)明：

也可選擇性地在兩個(gè)方括號(hào)中間加上一個(gè)空格：[text] [refid]。由于 Markdown 不支持自然換行，將兩個(gè)方括號(hào)在連續(xù)兩行書(shū)寫(xiě)也是沒(méi)問(wèn)題的。中間用空行隔開(kāi)，則被認(rèn)為是兩條精簡(jiǎn)格式的參考鏈接。
refid 可以與 text 一致，從而進(jìn)一步精簡(jiǎn)參考鏈接的書(shū)寫(xiě)格式：

此時(shí) [refid] 中的 refid 可以省略置空為 [] ：先定義 [text][] ，再定義 [text]:URL 。
你甚至可以將 [text][] 中的空中括號(hào)也省掉不寫(xiě)，進(jìn)一步簡(jiǎn)寫(xiě)為 [text] ，后面再定義 [text]:URL 。

refid 所指 href URL 在文件任意處給出定義即可。[refid]:URL 的 URL 后面可以選擇性地用單引號(hào)、雙引號(hào)或是括弧閉包起來(lái)標(biāo)記 title。
下面這三種鏈接的定義都是相同的：
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)

圖片（image href）

插入圖片

Markdown 使用一種和文本鏈接很相似的語(yǔ)法來(lái)插入圖片，同樣也允許兩種樣式：行內(nèi)式和參考式。
不同的是，需要在鏈接文字方括號(hào)之前添加一個(gè)感嘆號(hào)（exclamation mark：!），其語(yǔ)法格式為 ![alt_text](url)，HTML 等效源碼為 <img src="url" alt="text" />，其中alt_text可以置空。

daringfirefall logo:
![daringfirefall](http://daringfireball.net/graphics/logos/)
Markdown怎么使用

當(dāng)然，你也可以像文字鏈接那樣添加 title 以供鼠標(biāo)懸停提示。

說(shuō)明：
Markdown 中的段落（包括圖片）默認(rèn)頂格左對(duì)齊，若要將圖片居中，可以直接內(nèi)嵌 HTML 的 <img> 標(biāo)簽，設(shè)置align="middle"。如果還不行，可以嘗試封裹一層 div 設(shè)置 style="text-align:center" 實(shí)現(xiàn)：

<div style="text-align:center"><img src="http://avatar.csdn.net/9/D/B/1_phunxm.jpg" align="middle"  alt="程序猿-弦苦" /></div>1

Markdown怎么使用

圖片鏈接

如果拷貝了別人的圖片插入到自己的博客中，最好在圖片上給出一個(gè)超鏈接指向源頭，方便追溯出處。
我們?cè)?Markdown 圖片標(biāo)記![]()外面再嵌套一層[]()即可建立圖片超鏈接，點(diǎn)擊圖片即可跳轉(zhuǎn)到鏈接源地址。
圖片鏈接的格式看起來(lái)大概是這樣的:
[![](img_url)](ref_url)

定義 haroopad logo 指向首頁(yè)：
[![](http://pad.haroopress.com/assets/images/logo-small.png "haroopad")](http://pad.haroopress.com/)

Markdown怎么使用

錨點(diǎn)（inner link）

書(shū)簽（Bookmark）

HTML 中的 <a> 標(biāo)簽最重要的屬性是 href ，它指示的鏈接目標(biāo)，既可以是外部站點(diǎn)，也可以是頁(yè)內(nèi)錨點(diǎn)。頁(yè)內(nèi)錨點(diǎn)可以實(shí)現(xiàn)類似書(shū)簽跳轉(zhuǎn)的功能，最典型的就是點(diǎn)擊 TOC 中的目錄書(shū)簽跳轉(zhuǎn)到指定章節(jié)閱讀。
構(gòu)建頁(yè)內(nèi)錨點(diǎn)的語(yǔ)法，類似參考式鏈接：

先定義錨點(diǎn)id：<a href="#auchor_id">bookmark_text</a>
再定義一個(gè)id為auchor_id的對(duì)象（這里以為例）：auchor_text

例如，我們?cè)谖哪┒x了id為end的 EOF（End Of File）：The end！，然后通過(guò)<a href="#end">Goto the End!</a>指定書(shū)簽“Goto the End!”跳轉(zhuǎn)到文末“The End!”處：

Goto the End!

腳注（Footnote）

上面我們定義了書(shū)簽 Goto the End! ，點(diǎn)擊該書(shū)簽將跳轉(zhuǎn)到文末 id 為 #end 的錨點(diǎn)，使得我們能快速翻到文末。那怎么再跳轉(zhuǎn)回剛才書(shū)簽所在的閱讀點(diǎn)呢？下面來(lái)介紹一下具備回環(huán)跳轉(zhuǎn)效果的腳注。

腳注用于為正文中的某個(gè)條目添加補(bǔ)充注釋，對(duì)詞條的引文出處進(jìn)行標(biāo)注或?qū)I(yè)術(shù)語(yǔ)予以解釋，跟參考文獻(xiàn)一樣。腳注一般位于文檔的末尾，文內(nèi)則以數(shù)字標(biāo)注。

腳注的寫(xiě)法和極簡(jiǎn)參考式鏈接書(shū)寫(xiě)格式比較類似：

先在需要腳注的單詞（terminology）后面添加 [^Footnote] ： terminology[^Footnote]
再在文末 glossary 區(qū)域定義腳注（添加注解）： [^Footnote]：explanatory notes

以下是本文針對(duì)第二章標(biāo)題 “標(biāo)題（Header）”的著色添加的腳注：

## <font color='red'>標(biāo)題（Header）</font>[^Header]
[^Header]:這里的源碼為`<font color='red'>標(biāo)題（Header）</font>`，嘗試使用 font.color 著色。123

說(shuō)明：

被添加腳注的詞條后面會(huì)出現(xiàn)一個(gè)超鏈接數(shù)字（有的渲染為上標(biāo)格式），點(diǎn)擊數(shù)字跳轉(zhuǎn)到文末 glossary 區(qū)域該腳注的定義處。
文末 glossary 區(qū)域該腳注定義的行尾會(huì)添加一個(gè)回車符號(hào)（?），點(diǎn)擊可回到被標(biāo)注的腳注點(diǎn)。

引用（Blockquote）

HTML 中的 <blockquote> 標(biāo)簽定義摘自另一個(gè)源的塊引用。
<blockquote> 與 </blockquote> 之間的所有文本都會(huì)從常規(guī)文本中分離出來(lái)，經(jīng)常會(huì)在左右兩邊進(jìn)行縮進(jìn)，而且有時(shí)會(huì)使用斜體。也就是說(shuō)，塊引用擁有它們自己的空間。本文大量使用引用（復(fù)合列表）來(lái)標(biāo)識(shí)特殊說(shuō)明或注意事項(xiàng)。

Markdown 標(biāo)記區(qū)塊引用是使用類似 email 的引用方式，在斷好的行前加上 > （more than or greater than sign）：

> 愛(ài)上一個(gè)人  > 戀上一座城12

愛(ài)上一個(gè)人
戀上一座城

行首的多重引用標(biāo)記可以實(shí)現(xiàn)嵌套縮進(jìn)效果（注意解夢(mèng)時(shí)需要空行出夢(mèng)）：

> 夢(mèng)>> 夢(mèng)中夢(mèng)
>>> 盜夢(mèng)空間>
>> 夢(mèng)中夢(mèng)> 夢(mèng)1234567

夢(mèng)
夢(mèng)中夢(mèng)
盜夢(mèng)空間
夢(mèng)中夢(mèng)
夢(mèng)

說(shuō)明：

若使用引用格式插入代碼，行首的縮進(jìn)格式丟失，需要自行補(bǔ)充空格占位符。
一般不建議使用 blockquote（>）格式引用源代碼，應(yīng)采用 pre 格式引用代碼。
嵌套深入淺出時(shí)，需要添加空行（blank line）或者空引用行（additional levels of >）。

代碼（Code）

如果要標(biāo)記行內(nèi)代碼片段，可以用反引號(hào)（backtick quotes）閉包；如果要插入跨行片段或塊，可使用預(yù)格式化語(yǔ)法。
本文在示范 Markdown 語(yǔ)法源碼時(shí)，獨(dú)行單句采用了行內(nèi)代碼格式，跨行代碼片段則采用了代碼塊格式。

行內(nèi)代碼（Inline Code）

說(shuō)明：

如果要標(biāo)記行內(nèi)代碼片段，可以用反引號(hào)（backtick quotes）包裹，對(duì)應(yīng) HTML 中的 <code> 標(biāo)簽（把文本變成等寬字體，暗示是源程序代碼）。
如果要在代碼區(qū)段內(nèi)插入反引號(hào)，可以用多個(gè)反引號(hào)來(lái)開(kāi)啟和結(jié)束代碼區(qū)段。

語(yǔ)法：

Use the `printf()` function.(此處使用了反斜杠轉(zhuǎn)義)

示例：

Use the printf() function.(`printf()`)
Use the`printf()`function.(“ `printf()` “`)

代碼塊（Code Blocks）

說(shuō)明：

Preformatted Code Block
如果要插入跨行片段或塊，且要保持排版樣式（包括空格、換行符和縮進(jìn)），可使用預(yù)格式化引用語(yǔ)法格式。對(duì)應(yīng) HTML 中的 <pre> 標(biāo)簽。
Fenced Code Block
如果要支持編程語(yǔ)言語(yǔ)法高亮，則可以使用 GFM 擴(kuò)展的基于 YAML 2 標(biāo)記語(yǔ)言的 Fenced Code Block 引用語(yǔ)法格式。

語(yǔ)法：

Preformatted Code Block
在句段的行首插入1個(gè)tab 或 4個(gè)空格，則表示代碼塊。
[Fenced Code Block]
在句段行首和行末用三個(gè)反引號(hào)換行閉包，并在行首三個(gè)反引號(hào)后添加 YAML 語(yǔ)言標(biāo)識(shí)。

language	aliases
`Markdown`	無(wú)別名，注意區(qū)分大小寫(xiě)
`HTML`	`xhtml`
`JavaScript`	`js`、`node`
`C`	無(wú)別名，注意區(qū)分大小寫(xiě)
`C++`	`cpp`
`Objective-C`	`obj-c`、`objc`、`objectivec`
`VimL`	`vim`、`nvim`

示例：

1.Preformatted Code Block

將一段代碼塊整體向右縮進(jìn)（? + ]）即可測(cè)試。

（1）以tab開(kāi)頭：

these lines begin with tab will be shown as pre code block.
these lines begin with tab will be shown as pre code block.
these lines begin with tab will be shown as pre code block.1234

（2）以4個(gè)空格開(kāi)頭：

these lines begin with 4 spaces will also be shown as pre code block.
these lines begin with 4 spaces will also be shown as pre code block.
these lines begin with 4 spaces will also be shown as pre code block.1234

注意：

pre 格式存在以下缺陷：
對(duì)多tab及空格的縮進(jìn)支持不完善！
將宏符號(hào)#（#include、#import）誤解為H1，可能會(huì)影響解析器的TOC！
將頂格空白行（包括行首帶tab）誤認(rèn)為Paragraph Break，而割斷代碼塊成片段！

2.Fenced Code Block

Fenced Code Block 以三個(gè)反引號(hào)（backtick quotes：`，有的支持波浪線\~）包裹，第一行的三個(gè)反引號(hào)之后可以冠上編程語(yǔ)言的 YAML 標(biāo)記識(shí)別語(yǔ)法高亮。

以下演示插入一句 python 代碼：

首行（三個(gè)反引號(hào)開(kāi)頭）：“`python
中間：print(‘Hello world!’)
末行（三個(gè)反引號(hào)結(jié)尾）：“`

print('Hello world!')1

以下演示插入一段 Objective-C 代碼：

首行：“`obj-c
中間：Objective-C Code Block
末行：“`

////  main.m//  EmptyApplication////  Created by faner on 15/9/5.//  Copyright ? 2015年 faner. All rights reserved.//#import <UIKit/UIKit.h>
#import "AppDelegate.h"int main(int argc, char * argv[]) {    @autoreleasepool {        return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));
    }
}12345678910111213141516

注意：

Haroopad 編輯器將上述代碼中的#import的第一個(gè)有效字符#誤解為 H1 ，導(dǎo)致 TOC 錯(cuò)亂或 Heading Focus Folding 失效。此時(shí)，可嘗試在 Fenced Code Block 行首添加空格或 tab 縮進(jìn)。
關(guān)于 GitHub 配置 Fenced Code Block 語(yǔ)法高亮所使用的 YAML 標(biāo)記，可參考初探Y(jié)AML 、 YAML學(xué)習(xí) 、 YAML學(xué)習(xí)總結(jié) 、 YAML–想要愛(ài)你很容易。

列表（List）

GFM 等 Markdown 擴(kuò)展支持和無(wú)序列表、有序列表和任務(wù)列表。

無(wú)序列表（Unordered List）

無(wú)序列表（unordered, bulleted）項(xiàng)目的行首使用星號(hào)（或加號(hào)，或減號(hào)）加空格作為列表標(biāo)記（list markers）：

- bullet list item 1 begin with a hyphens '-'+ bullet list item 2 begin with a pluses '+'* bullet list item 3 begin with an asterisks '*'123

示例效果：

bullet list item 1 begin with a ‘-‘
bullet list item 2 begin with a ‘+’
bullet list item 3 begin with a ‘*’

通過(guò)在列表標(biāo)記前面增加 tab 階次來(lái)實(shí)現(xiàn)嵌套效果（nested list）。
以下是針對(duì)本文 TOC 中【鏈接】這一章節(jié)的目錄：

- 鏈接（Hyperlink）    - 自動(dòng)鏈接（Autolink） <!--行首縮進(jìn)1個(gè)tab-->    - 文字（text href）        - 行內(nèi)式（Inline） <!--行首縮進(jìn)2個(gè)tab-->        - 參考式（Reference）    - 圖片（image href）        - 插入圖片        - 圖片鏈接    - 錨點(diǎn)（inner link）        - 書(shū)簽（Bookmark）        - 腳注（Footnote）- 引用（Blockquote）123456789101112

鏈接（Hyperlink）

書(shū)簽（Bookmark）
腳注（Footnote）
插入圖片
圖片鏈接
行內(nèi)式（Inline）
參考式（Reference）
自動(dòng)鏈接（Autolink）
文字（text href）
圖片（image href）
錨點(diǎn)（inner link）

引用（Blockquote）

縮進(jìn)控制符：空格 or TAB？

在列表標(biāo)記前面插入空格也可以實(shí)現(xiàn)縮進(jìn)控制嵌套效果，但不同的 Markdown Render 對(duì)控制層級(jí)的空格個(gè)數(shù)要求不一。
為了取得最佳的兼容性，建議使用 tab 來(lái)控制嵌套層級(jí)（nested hierarchy），以期在不同的渲染引擎下都能達(dá)到預(yù)期的顯示效果。當(dāng)然，前提是使用 hard tabs（tab characters），而非 soft tabs（spaces）。

有序列表（Ordered List）

有序列表（ordered / numbered）項(xiàng)目的行首則使用數(shù)字接一個(gè)英文句點(diǎn)標(biāo)記（use numbers followed by periods）：

1. GETTING STARTED  
    Choosing Blogging Platform (WordPress)2. GETTING YOUR BLOG ONLINE  
    Choosing Domain Name & Web Hosting3. DESIGNING AND TWEAKING YOUR BLOG  
    Quick and easy ways to get your blog look the way you want4. WRITING BLOG POSTS AND PAGES  
    Adding new content for your Blog (Posts, Pages, Images etc…)12345678

Step-by-step walkthrough for starting a blog :

GETTING STARTED
Choosing Blogging Platform (WordPress)
GETTING YOUR BLOG ONLINE
Choosing Domain Name & Web Hosting
DESIGNING AND TWEAKING YOUR BLOG
Quick and easy ways to get your blog look the way you want
WRITING BLOG POSTS AND PAGES
Adding new content for your Blog (Posts, Pages, Images etc…)

有序列表和無(wú)序列表可以實(shí)現(xiàn)混合嵌套編排。

任務(wù)列表（Task Lit）

GFM 擴(kuò)展支持把列表變成帶勾選框的任務(wù)列表，只需要在列表標(biāo)記后添加[ ]標(biāo)記?表示unchecked，在中括號(hào)中填寫(xiě)x（[x]）標(biāo)記??表示checked（filled）。

- [ ] task1 to do- [x] task2 done1. [ ] task3 to do2. [x] task4 done1234

[ ] task1 to do
[x] task2 done

[ ] task3 to do
[x] task4 done

表格（Table）

You can create tables by assembling a list of words and dividing them with hyphens - (for the first row), and then separating each column with a pipe | (vertical bar):

First Header	Second Header
Content Cell	Content Cell
Content Cell	Content Cell

For aesthetic purposes, you can also add extra pipes on the ends:

First Header	Second Header
Content Cell	Content Cell
Content Cell	Content Cell

Note that the dashes at the top don’t need to match the length of the header text exactly:

Name	Description
Help	Display the help window.
Close	Closes a window

You can also include inline Markdown such as links, bold, italics, or strikethrough:

Name	Description
Help	Display the help window.
Close	Closes a window

Finally, by including colons : within the header row, you can define text to be left-aligned, right-aligned, or center-aligned:

Left-Aligned	Center Aligned	Right Aligned
col 3 is	some wordy text	$1600
col 2 is	centered	$12
zebra stripes	are neat	$1

A colon on the left-most side indicates a left-aligned column; a colon on the right-most side indicates a right-aligned column; a colon on both sides indicates a center-aligned column.

數(shù)學(xué)公式

You can render LaTeX3 mathematical expressions using MathJax4 , as on math.stackexchange.com:
The Gamma function satisfying Γ(n)=(n?1)!?n∈NΓ(n)=(n?1)!?n∈N is via the Euler integral

Γ(z)=∫∞tz?1e?tdt.Γ(z)=∫0∞tz?1e?tdt.

書(shū)寫(xiě)一個(gè)質(zhì)能守恒公式

E=mc2E=mc2

The end！

這里的源碼為標(biāo)題（Header），嘗試使用 font.color 著色。 ?
YAML 是”YAML Ain’t a Markup Language”（YAML不是一種置標(biāo)語(yǔ)言）的遞歸縮寫(xiě)，早先YAML的意思其實(shí)是：”Yet Another Markup Language”（另外一種置標(biāo)語(yǔ)言）。 ?
LaTeX 是一種基于 ΤΕΧ 的排版系統(tǒng)，它通過(guò)\section和\paragraph等語(yǔ)句，規(guī)定了每一句話在文章中所從屬的層次，從而極大方便了對(duì)各個(gè)層次批量處理。
MatchJax 是一個(gè)JavaScript引擎，用來(lái)顯示網(wǎng)絡(luò)上的數(shù)學(xué)公式。MathJax可以解析Latex、MathML和ASCIIMathML的標(biāo)記語(yǔ)言。 ?

以上就是關(guān)于“Markdown怎么使用”這篇文章的內(nèi)容，相信大家都有了一定的了解，希望小編分享的內(nèi)容對(duì)大家有幫助，若想了解更多相關(guān)的知識(shí)內(nèi)容，請(qǐng)關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道。

網(wǎng)站題目：Markdown怎么使用
文章源于：http://chinadenli.net/article16/ggjegg.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供外貿(mào)建站、營(yíng)銷型網(wǎng)站建設(shè)、手機(jī)網(wǎng)站建設(shè)、網(wǎng)站改版、虛擬主機(jī)、微信小程序

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請(qǐng)盡快告知，我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng)，如需處理請(qǐng)聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時(shí)需注明來(lái)源：創(chuàng)新互聯(lián)

猜你還喜歡下面的內(nèi)容

entity	code	full-name	width
` `	` `	no-break space	鍵盤(pán)空格（space bar）
`&ensp;`	` `	en space	半角空格（half-width）
`&emsp;`	` `	em space	全角空格（full-width）

entity	code	full-name	width
` `	` `	no-break space	鍵盤(pán)空格（space bar）
`&ensp;`	` `	en space	半角空格（half-width）
`&emsp;`	` `	em space	全角空格（full-width）

欧美一区二区三区老妇人-欧美做爰猛烈大尺度电-99久久夜色精品国产亚洲a-亚洲福利视频一区二区

Markdown怎么使用

標(biāo)題（Header）1

Setext Heading Format（2 level）

Atx Heading Format（6 level）

句段（Sentence / Paragraph）

換行

分段

符號(hào)（Punctuation Characters）

轉(zhuǎn)義字符

字符實(shí)體

分隔線（Horizontal Rules）

文本格式（Text Styling）

強(qiáng)調(diào)（Italic/Emphasize）

加粗（Bold/Strong）

突出（Mark/Highlight）

下劃線（Underline）

刪除線（Strikethrough）

腳標(biāo)（Script）

上腳標(biāo)：

下腳標(biāo)：

鏈接（Hyperlink）

自動(dòng)鏈接（Autolink）

文字（text href）

行內(nèi)式（Inline）

參考式（Reference）

圖片（image href）

插入圖片

圖片鏈接

錨點(diǎn)（inner link）

書(shū)簽（Bookmark）

腳注（Footnote）

引用（Blockquote）

代碼（Code）

行內(nèi)代碼（Inline Code）

代碼塊（Code Blocks）

列表（List）

無(wú)序列表（Unordered List）

有序列表（Ordered List）

任務(wù)列表（Task Lit）

表格（Table）

數(shù)學(xué)公式

entity	code	full-name	width
` `	` `	no-break space	鍵盤(pán)空格（space bar）
`&ensp;`	` `	en space	半角空格（half-width）
`&emsp;`	` `	em space	全角空格（full-width）