第01節(jié) Markdown標(biāo)題

2018-08-09 15:16 更新

  Html 中通常使用<H1>-<H6>這六種標(biāo)簽對(duì)來(lái)表示六級(jí)標(biāo)題。所以在 Markdown 標(biāo)準(zhǔn)語(yǔ)法中也定義了標(biāo)題。

標(biāo)題分類

  Markdown 語(yǔ)法中,標(biāo)題有兩種:Atx 方式和 Setext 方式。但本程序只支持 Atx 方式。

  因?yàn)樵趯?shí)現(xiàn)折疊功能時(shí)易導(dǎo)致沖突,且易和水平線相混淆,故本程序屏蔽了 Setext 方式的標(biāo)題。

  • Atx 方式的標(biāo)題

  以#符開(kāi)頭,共六級(jí),一級(jí)就以一個(gè)#開(kāi)頭,二級(jí)就以兩個(gè)#開(kāi)頭(寫(xiě)成##),其余依此類推。

  下面是個(gè)三級(jí)的 Atx 方式的標(biāo)題:

###這是個(gè)三級(jí)標(biāo)題
  • Setext 方式的標(biāo)題

  在標(biāo)題文本下緊跟一行至少三個(gè)減號(hào)(有些 Markdown 編輯器中也支持等于號(hào))。

  本程序因?yàn)橐С志庉嫊r(shí)六級(jí)標(biāo)題折疊功能,如果同時(shí)支持這兩種標(biāo)題格式,容易導(dǎo)致折疊區(qū)混亂,所以不支持這種方式!

關(guān)于標(biāo)題的折疊功能

  在編輯區(qū),六級(jí)標(biāo)題都支持折疊/展開(kāi);編譯成 Html 文檔后,仍然支持折疊/展開(kāi)。

  Html 中的折疊/展開(kāi)是利用 JavaScript 腳本實(shí)現(xiàn)的(引用了 jQuery 庫(kù))。所以如果瀏覽器禁用 JavaScript 腳本的話,它是不起作用的。

關(guān)于標(biāo)題層級(jí)的斷裂與格式化

  如果一個(gè)三級(jí)標(biāo)題后緊跟一個(gè)五級(jí)標(biāo)題,本程序就認(rèn)為這兩個(gè)標(biāo)題之間出現(xiàn)了“斷裂”。

  斷裂的標(biāo)題會(huì)被自動(dòng)降級(jí)到比前一個(gè)標(biāo)題高一級(jí)的水平。

  例如:一個(gè)三級(jí)標(biāo)題下緊跟一個(gè)五級(jí)標(biāo)題,則該五級(jí)標(biāo)題會(huì)被自動(dòng)格式化為四級(jí)標(biāo)題。

  但如果一個(gè)三級(jí)標(biāo)題后緊跟一個(gè)一級(jí)標(biāo)題,則并不算“斷裂”——這個(gè)一級(jí)標(biāo)題會(huì)被視為“終結(jié)”了三級(jí)標(biāo)題的控制區(qū)域。

  當(dāng)標(biāo)題層級(jí)出現(xiàn)斷裂的情況時(shí),會(huì)自動(dòng)縮減標(biāo)題層級(jí)。如下所示:

#標(biāo)題1
#標(biāo)題2
##標(biāo)題3
#標(biāo)題4
###標(biāo)題5
######標(biāo)題6

  標(biāo)題1到標(biāo)題4都是連續(xù)的,它們或者與前一個(gè)標(biāo)題同級(jí),或者比前一個(gè)層級(jí)高一級(jí)。

  標(biāo)題3→標(biāo)題4也沒(méi)問(wèn)題,標(biāo)題4的層級(jí)比標(biāo)題3低(無(wú)論低幾級(jí)都沒(méi)問(wèn)題)。

  但標(biāo)題5相對(duì)于標(biāo)題4就出現(xiàn)了斷裂,因?yàn)闃?biāo)題5比標(biāo)題4高2級(jí)!

  而標(biāo)題六比之標(biāo)題5也是斷裂的。

  實(shí)際編譯時(shí),會(huì)被自動(dòng)格式化為下面這個(gè)樣子:

#標(biāo)題1
#標(biāo)題2
##標(biāo)題3
#標(biāo)題4
##標(biāo)題5
###標(biāo)題6

  出現(xiàn)斷裂的標(biāo)題會(huì)被格式化成前一標(biāo)題的直接下級(jí)。如上例所示:

  標(biāo)題5是三級(jí),而標(biāo)題4是一級(jí),于是將標(biāo)題5格式化為二級(jí);

  標(biāo)題5被格式化為二級(jí)后,發(fā)現(xiàn)標(biāo)題6是六級(jí),于是將標(biāo)題六格式化成三級(jí)。

  我們還可以試試在一個(gè)空白文件中按下面這樣書(shū)寫(xiě):

######標(biāo)題1
######標(biāo)題2
######標(biāo)題3
######標(biāo)題4
######標(biāo)題5
######標(biāo)題6

  格式化后會(huì)變成這樣:

#標(biāo)題1
##標(biāo)題2
###標(biāo)題3
####標(biāo)題4
#####標(biāo)題5
######標(biāo)題6

怎樣避免編譯后的 Html 頁(yè)面中的標(biāo)題自動(dòng)折疊?

  在主菜單中選中編譯Html 編譯選項(xiàng)→勾選<H1>...<H6> 不折疊即可。

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)