第01節(jié) Markdown標題

2018-08-09 15:16 更新

  Html 中通常使用<H1>-<H6>這六種標簽對來表示六級標題。所以在 Markdown 標準語法中也定義了標題。

標題分類

  Markdown 語法中,標題有兩種:Atx 方式和 Setext 方式。但本程序只支持 Atx 方式。

  因為在實現(xiàn)折疊功能時易導致沖突,且易和水平線相混淆,故本程序屏蔽了 Setext 方式的標題。

  • Atx 方式的標題

  以#符開頭,共六級,一級就以一個#開頭,二級就以兩個#開頭(寫成##),其余依此類推。

  下面是個三級的 Atx 方式的標題:

###這是個三級標題
  • Setext 方式的標題

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

  本程序因為要支持編輯時六級標題折疊功能,如果同時支持這兩種標題格式,容易導致折疊區(qū)混亂,所以不支持這種方式!

關于標題的折疊功能

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

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

關于標題層級的斷裂與格式化

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

  斷裂的標題會被自動降級到比前一個標題高一級的水平。

  例如:一個三級標題下緊跟一個五級標題,則該五級標題會被自動格式化為四級標題。

  但如果一個三級標題后緊跟一個一級標題,則并不算“斷裂”——這個一級標題會被視為“終結”了三級標題的控制區(qū)域。

  當標題層級出現(xiàn)斷裂的情況時,會自動縮減標題層級。如下所示:

#標題1
#標題2
##標題3
#標題4
###標題5
######標題6

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

  標題3→標題4也沒問題,標題4的層級比標題3低(無論低幾級都沒問題)。

  但標題5相對于標題4就出現(xiàn)了斷裂,因為標題5比標題4高2級!

  而標題六比之標題5也是斷裂的。

  實際編譯時,會被自動格式化為下面這個樣子:

#標題1
#標題2
##標題3
#標題4
##標題5
###標題6

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

  標題5是三級,而標題4是一級,于是將標題5格式化為二級;

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

  我們還可以試試在一個空白文件中按下面這樣書寫:

######標題1
######標題2
######標題3
######標題4
######標題5
######標題6

  格式化后會變成這樣:

#標題1
##標題2
###標題3
####標題4
#####標題5
######標題6

怎樣避免編譯后的 Html 頁面中的標題自動折疊?

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

以上內容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號