markdown語(yǔ)法

文本

一個(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到6

  AAA
  ===
  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

  1. ABC
  2. BCD
  3. CED

引用

ASP.NET Core is a signi?cant redesign of ASP.NET.

aaaaa
bbbbb

ccccc
ddddd

eee

  • AAA

    HI

    ABC
    ABCDEF

    123

    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:

demo1

Example1:

Baidu

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:

Baidu

Google

pic example2:

BaiduLogo

GoogleLogo

其他

自動(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)

更多詳情查看 https://github.com/WeihanLi/markdown-syntax-summary

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市舷礼,隨后出現(xiàn)的幾起案子泻轰,更是在濱河造成了極大的恐慌,老刑警劉巖且轨,帶你破解...
    沈念sama閱讀 211,376評(píng)論 6 491
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異虚婿,居然都是意外死亡旋奢,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,126評(píng)論 2 385
  • 文/潘曉璐 我一進(jìn)店門(mén)然痊,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)至朗,“玉大人,你說(shuō)我怎么就攤上這事剧浸∏乱” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 156,966評(píng)論 0 347
  • 文/不壞的土叔 我叫張陵唆香,是天一觀(guān)的道長(zhǎng)嫌变。 經(jīng)常有香客問(wèn)我,道長(zhǎng)躬它,這世上最難降的妖魔是什么腾啥? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 56,432評(píng)論 1 283
  • 正文 為了忘掉前任,我火速辦了婚禮冯吓,結(jié)果婚禮上倘待,老公的妹妹穿的比我還像新娘。我一直安慰自己组贺,他們只是感情好凸舵,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,519評(píng)論 6 385
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著失尖,像睡著了一般啊奄。 火紅的嫁衣襯著肌膚如雪渐苏。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 49,792評(píng)論 1 290
  • 那天增热,我揣著相機(jī)與錄音整以,去河邊找鬼。 笑死峻仇,一個(gè)胖子當(dāng)著我的面吹牛公黑,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播摄咆,決...
    沈念sama閱讀 38,933評(píng)論 3 406
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼凡蚜,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了吭从?” 一聲冷哼從身側(cè)響起朝蜘,我...
    開(kāi)封第一講書(shū)人閱讀 37,701評(píng)論 0 266
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎涩金,沒(méi)想到半個(gè)月后谱醇,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 44,143評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡步做,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,488評(píng)論 2 327
  • 正文 我和宋清朗相戀三年副渴,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片全度。...
    茶點(diǎn)故事閱讀 38,626評(píng)論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡煮剧,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出将鸵,到底是詐尸還是另有隱情勉盅,我是刑警寧澤,帶...
    沈念sama閱讀 34,292評(píng)論 4 329
  • 正文 年R本政府宣布顶掉,位于F島的核電站草娜,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏一喘。R本人自食惡果不足惜驱还,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,896評(píng)論 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望凸克。 院中可真熱鬧议蟆,春花似錦、人聲如沸萎战。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,742評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)蚂维。三九已至戳粒,卻和暖如春路狮,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背蔚约。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,977評(píng)論 1 265
  • 我被黑心中介騙來(lái)泰國(guó)打工奄妨, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人苹祟。 一個(gè)月前我還...
    沈念sama閱讀 46,324評(píng)論 2 360
  • 正文 我出身青樓砸抛,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親树枫。 傳聞我的和親對(duì)象是個(gè)殘疾皇子直焙,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,494評(píng)論 2 348

推薦閱讀更多精彩內(nèi)容