文本
一個(gè) Markdown 段落是由一個(gè)或多個(gè)連續(xù)的文本行組成排抬,它的前后要有一個(gè)以上的空行 (空行的定義是顯示上看起來(lái)像是空的懂从,便會(huì)被視為空行。比方說(shuō)蹲蒲,若某一行只包含空格 和制表符番甩,則該行也會(huì)被視為空行)。普通段落不該用空格或制表符來(lái)縮進(jìn)届搁。
如果想要依賴(lài) Markdown 來(lái)插入<br />
標(biāo)簽的話(huà)缘薛,在插入處先按入兩個(gè)以上的空 格然后回車(chē)。
AAA BBB CCC DDD
AAA BBB
CCC
DDD
如果要標(biāo)記一小段行內(nèi)代碼卡睦,你可以用反引號(hào)把它包起來(lái)(`)
I love C#,C# Programing language output "HelloWorld",`Console.WriteLine("HelloWorld");`.So beautiful!
I love C#,C# Programing language output "HelloWorld",Console.WriteLine("HelloWorld");
.So beautiful!
如果要在代碼區(qū)段內(nèi)插入反引號(hào)宴胧,你可以用多個(gè)反引號(hào)來(lái)開(kāi)啟和結(jié)束代碼區(qū)段:
Example as follows: ``There is a literal backtick (`) here.`` Interesting! A single backtick in a code span: `` ` `` A backtick-delimited string in a code span: `` `foo` ``
Example as follows: There is a literal backtick (`) here.
Interesting!
A single backtick in a code span: `
A backtick-delimited string in a code span: `foo`
Markdown 使用星號(hào)(*)和底線(xiàn)(_)作為標(biāo)記強(qiáng)調(diào)字詞的符號(hào),被 * 或 _ 包圍的字詞會(huì) 被轉(zhuǎn)成用 <em> 標(biāo)簽包圍表锻,用兩個(gè) * 或 _ 包起來(lái)的話(huà)恕齐,則會(huì)被轉(zhuǎn)成 <strong>
*ABC* _ABC_ **ABC** __ABC__
ABC
ABC
ABC
ABC
特殊字符
? > < & AT&T 4<5
?
<
&
AT&T
4<5
標(biāo)題
標(biāo)題語(yǔ)法
Markdown 支持兩種標(biāo)題的語(yǔ)法,類(lèi) Setext 和類(lèi) atx 形式浩嫌。
類(lèi) Setext 形式是用底線(xiàn)的形式檐迟,利用 =(最高階標(biāo)題)和 -(第二階標(biāo)題
類(lèi) Atx 形式是在行首插入1到6個(gè)# ,對(duì)應(yīng)到標(biāo)題1到6AAA === BBB ---
AAA
BBB
# 這是一級(jí)標(biāo)題 ## 這是二級(jí)標(biāo)題 ### 這是三級(jí)標(biāo)題 #### 這是四級(jí)標(biāo)題
這是一級(jí)標(biāo)題
這是二級(jí)標(biāo)題
這是三級(jí)標(biāo)題
這是四級(jí)標(biāo)題
列表
- AAA
- aaa
- bbb
- ccc
- BBB
- CCC
XXX
YYY
ZZZ
CCC
DDD
EEE
- ABC
- BCD
- CED
引用
ASP.NET Core is a signi?cant redesign of ASP.NET.
aaaaa
bbbbb
ccccc
ddddd
eee
-
AAA
HI
ABC
ABCDEF123
789
456
-
BBB
HELLO
代碼區(qū)塊
要在 Markdown 中建立代碼區(qū)塊很簡(jiǎn)單码耐,只要簡(jiǎn)單地縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符就可以了
C# code below:
public void Hello()
{
Console.WriteLine("HelloWorld");
}
JavaScript code Below:
function hello(){
console.log('Hello JavaScript');
}
HTML code Below:
<!DOCTYPE HTML> <html> <head> <meta charset="utf-8"/> <title>h5 template</title> </head> <body> </body> </html>
分隔線(xiàn)
你可以在一行中用三個(gè)以上的星號(hào)追迟、底線(xiàn)來(lái)建立一個(gè)分隔線(xiàn),行內(nèi)不能有其他東西骚腥。你也可以在星號(hào)或是減號(hào)中間插入空格
aaa
bbb
ccc
鏈接
Markdown 支持兩種形式的鏈接語(yǔ)法:行內(nèi)式 和 參考式 兩種形式
要建立一個(gè) 行內(nèi)式 的鏈接敦间,只要在方塊括號(hào)后面緊接著圓括號(hào)并插入網(wǎng)址鏈接即可,如果 你還想要加上鏈接的 title 文字束铭,只要在網(wǎng)址后面廓块,用雙引號(hào)把 title 文字包起來(lái)即可
參考式 的鏈接是在鏈接文字的括號(hào)后面再接上另一個(gè)方括號(hào),而在第二個(gè)方括號(hào)里面要填入用以辨識(shí)鏈接的標(biāo)記,接著契沫,在文件的任意處带猴,你可以把這個(gè)標(biāo)記的鏈接內(nèi)容定義出來(lái)
Example0:
Example1:
Example2:
I get 10 times more traffic from Google than from Yahoo or Bing.
Example3:
I get 10 times more traffic from Google than from Yahoo or bing.
圖片
Markdown 使用一種和鏈接很相似的語(yǔ)法來(lái)標(biāo)記圖片,同樣也允許兩種樣式:行內(nèi)式 和 參考式
行內(nèi)式的圖片語(yǔ)法看起來(lái)像是:![Alt text](/path/to/img.jpg) ![Alt text](/path/to/img.jpg "Optional title")
一個(gè)驚嘆號(hào) ! ,接著一個(gè)方括號(hào)懈万,里面放上圖片的替代文字,接著一個(gè)普通括號(hào)拴清,里面放上圖片的地址靶病,最后還可以用引號(hào)包住并加上 選擇性 的 'title' 文字
參考式的圖片語(yǔ)法則長(zhǎng)得像這樣:![Alt text][id]
id是圖片參考的名稱(chēng),圖片參考的定義方式則和鏈接參考一樣
logo of Baidu and Google
pic example1:
pic example2:
其他
自動(dòng)鏈接
Markdown 支持以比較簡(jiǎn)短的自動(dòng)鏈接形式來(lái)處理網(wǎng)址和電子郵件信箱口予,只要是用尖括號(hào) 包起來(lái)娄周, Markdown 就會(huì)自動(dòng)把它轉(zhuǎn)成鏈接。一般網(wǎng)址的鏈接文字就和鏈接地址一樣
郵址的自動(dòng)鏈接也很類(lèi)似沪停,只是 Markdown 會(huì)先做一個(gè)編碼轉(zhuǎn)換的過(guò)程煤辨,把文字字符轉(zhuǎn)成 16 進(jìn)位碼的 HTML 實(shí)體,這樣的格式可以糊弄一些不好的郵址收集機(jī)器人
<http://cn.bing.com>
<ben121011@126.com>
http://cn.bing.com
ben121011@126.com
妙用反斜杠
Markdown 可以利用反斜杠來(lái)插入一些在語(yǔ)法中有其它意義的符號(hào)木张,例如:如果你想要用 星號(hào)加在文字旁邊的方式來(lái)做出強(qiáng)調(diào)效果(但不用 <em> 標(biāo)簽)众辨,你可以在星號(hào)的前面加 上反斜杠
*literal asterisks*
*literal asterisks*
*literal asterisks*
*literal asterisks*
Markdown 支持以下這些符號(hào)前面加上反斜杠來(lái)幫助插入普通的符號(hào):
\ 反斜線(xiàn) ` 反引號(hào) * 星號(hào) _ 底線(xiàn) {} 花括號(hào) [] 方括號(hào) () 括弧 # 井字號(hào) + 加號(hào) - 減號(hào) . 英文句點(diǎn) ! 驚嘆號(hào)