markdown語(yǔ)法

文本

一個(gè) Markdown 段落是由一個(gè)或多個(gè)連續(xù)的文本行組成,它的前后要有一個(gè)以上的空行 (空行的定義是顯示上看起來(lái)像是空的,便會(huì)被視為空行。比方說(shuō),若某一行只包含空格 和制表符,則該行也會(huì)被視為空行)。普通段落不該用空格或制表符來(lái)縮進(jìn)。
如果想要依賴 Markdown 來(lái)插入 <br /> 標(biāo)簽的話,在插入處先按入兩個(gè)以上的空 格然后回車。

  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)(*)和底線(_)作為標(biāo)記強(qiáng)調(diào)字詞的符號(hào),被 * 或 _ 包圍的字詞會(huì) 被轉(zhuǎn)成用 <em> 標(biāo)簽包圍,用兩個(gè) * 或 _ 包起來(lái)的話,則會(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ǔ)法,類 Setext 和類 atx 形式。
類 Setext 形式是用底線的形式,利用 =(最高階標(biāo)題)和 -(第二階標(biāo)題
類 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>

分隔線

你可以在一行中用三個(gè)以上的星號(hào)、底線來(lái)建立一個(gè)分隔線,行內(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是圖片參考的名稱,圖片參考的定義方式則和鏈接參考一樣

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)鏈接也很類似,只是 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):

  \ 反斜線 
  ` 反引號(hào)
  * 星號(hào) 
  _ 底線
  {} 花括號(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)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

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