Markdown語(yǔ)法

區(qū)塊引用 Blockquotes

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,

consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.

Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.


標(biāo)題

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

類 Setext 形式是用底線的形式,利用=(最高階標(biāo)題)和-(第二階標(biāo)題),例如:

This is an H1

=============

This is an H2

-------------

任何數(shù)量的=和-都可以有效果。

類 Atx 形式則是在行首插入 1 到 6 個(gè)#,對(duì)應(yīng)到標(biāo)題 1 到 6 階,例如:

# 這是 H1

## 這是 H2

###### 這是 H6

引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語(yǔ)法,包括標(biāo)題、列表、代碼區(qū)塊等:

> ## 這是一個(gè)標(biāo)題。

>

> 1.? 這是第一行列表項(xiàng)。

> 2.? 這是第二行列表項(xiàng)。

>

> 給出一些例子代碼:

>

> ? ? ? ? ? return shell_exec("echo $input | $markdown_script");


列表

Markdown 支持有序列表和無(wú)序列表。

無(wú)序列表使用星號(hào)、加號(hào)或是減號(hào)作為列表標(biāo)記:

*? Red

*? Green

*? Blue

等同于:

+? Red

+? Green

+? Blue

也等同于:

-? Red

-? Green

-? Blue

有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn):

1.? Bird

2.? McHale

3.? Parish


代碼區(qū)塊

和程序相關(guān)的寫作或是標(biāo)簽語(yǔ)言原始碼通常會(huì)有已經(jīng)排版好的代碼區(qū)塊,通常這些區(qū)塊我們并不希望它以一般段落文件的方式去排版,而是照原來(lái)的樣子顯示,Markdown 會(huì)用

標(biāo)簽來(lái)把代碼區(qū)塊包起來(lái)。

要在 Markdown 中建立代碼區(qū)塊很簡(jiǎn)單,只要簡(jiǎn)單地縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符就可以。

如果要標(biāo)記一小段行內(nèi)代碼,你可以用反引號(hào)把它包起來(lái)(`)

分隔線

你可以在一行中用三個(gè)以上的星號(hào)、減號(hào)、底線來(lái)建立一個(gè)分隔線,行內(nèi)不能有其他東西。你也可以在星號(hào)或是減號(hào)中間插入空格。下面每種寫法都可以建立分隔線:

* * *

***

*****

- - -

---------------------------------------



強(qiáng)調(diào)

Markdown 使用星號(hào)(*)和底線(_)作為標(biāo)記強(qiáng)調(diào)字詞的符號(hào),被*或_包圍的字詞會(huì)被轉(zhuǎn)成用標(biāo)簽包圍,用兩個(gè)*或_包起來(lái)的話,則會(huì)被轉(zhuǎn)成


鏈接

Markdown 支持兩種形式的鏈接語(yǔ)法:行內(nèi)式參考式兩種形式。

不管是哪一種,鏈接文字都是用 [方括號(hào)] 來(lái)標(biāo)記。

要建立一個(gè)行內(nèi)式的鏈接,只要在方塊括號(hào)后面緊接著圓括號(hào)并插入網(wǎng)址鏈接即可,如果你還想要加上鏈接的 title 文字,只要在網(wǎng)址后面,用雙引號(hào)把 title 文字包起來(lái)即可,例如:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.


參考式的鏈接是在鏈接文字的括號(hào)后面再接上另一個(gè)方括號(hào),而在第二個(gè)方括號(hào)里面要填入用以辨識(shí)鏈接的標(biāo)記:

This is [an example][id] reference-style link.

你也可以選擇性地在兩個(gè)方括號(hào)中間加上一個(gè)空格:

This is [an example] [id] reference-style link.

接著,在文件的任意處,你可以把這個(gè)標(biāo)記的鏈接內(nèi)容定義出來(lái):

[id]: http://example.com/? "Optional Title Here"

鏈接內(nèi)容定義的形式為:

方括號(hào)(前面可以選擇性地加上至多三個(gè)空格來(lái)縮進(jìn)),里面輸入鏈接文字

接著一個(gè)冒號(hào)

接著一個(gè)以上的空格或制表符

接著鏈接的網(wǎng)址

選擇性地接著 title 內(nèi)容,可以用單引號(hào)、雙引號(hào)或是括弧包著

下面這三種鏈接的定義都是相同:

[foo]: http://example.com/? "Optional Title Here"

[foo]: http://example.com/? 'Optional Title Here'

[foo]: http://example.com/? (Optional Title Here)

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容