第03節(jié) Markdown中文格式符

2018-08-09 15:16 更新

為啥要支持中文格式符?

  Markdown 使用一些簡單的字符表示某種需要轉譯為 html 標簽的格式定義。標準 Markdown 的格式格式標志字符都是英文的。

  但由于我主要用以編輯中文文檔,每次輸入這些標簽時都需要切換到英文狀態(tài),有些繁瑣且易錯。

  例如:

> 引用塊

  上面這行文本編輯成 html 會是這樣的效果:

引用塊

  但我希望在中文狀態(tài)下也能快速輸入,當在中文輸入狀態(tài)下時,按Shift+>會輸入右雙書名號,這時可以這樣子輸入:

》 引用塊

  轉譯成 html 后效果與上面相同:

引用塊

  通常情況下,Markdown 要求在某行文本的開頭用一個英文(半角)大于號字符(即右尖括號)后面加上一個半角空格才能定義一個文本塊。——也就是以開頭的行才算引用塊。

  但我覺得不方便,于是去除了對半角空格的要求——只要某行以>開頭,都算文本塊。

  在去除了對這個空格的要求后,格式化 Markdown 文本時往往會造成當前插入點光標位置變動——這是因為格式化時自動添加了空格。

  實際上,即使不格式化,也照樣編譯為 Html ——結果一樣。

支持哪些中文格式字符?

  Markdown 本身較為復雜,而且還支持直接嵌入 Html 標簽,所以幾乎不可能做到中英文格式字符一一對應。

  在制作這個程序時,僅僅是根據(jù)使用中最常見的幾種情況來提供了中文(全角)格式字符的支持:

  • 》 (右雙書名號加半角空格)或》 (右雙書名號加全角空格)開頭,相當于以開頭。

  • 用以劃分表格行中各單元格的豎線。全角的字符和半角的|字符在編譯為html時等效。

  但是如果你想在正文、引用塊中呈現(xiàn)這兩個字符本身(而不是解釋為表格單元格分隔符),你需要輸入這兩個字符的 Unicode 編碼。全角豎線的   Unicode 編碼是|,半角豎線則是|。

注意:代碼塊、列表項中的豎線字符(無論全角、半角)均會被解釋為本身而不是表格單元格分隔線。
  • 以分號開頭的行是注釋行,不會被編譯到 Html 文檔中。以中文全角分號開頭或者以半角英文分號;開頭效果是一樣的。

  • 以冒號開頭的行也是注釋行,但是會被編譯到 Html 文檔中。全角冒號、半角冒號作用相同。

  例如:

:注釋文本01
:注釋文本02

  編譯為 Html 后會呈現(xiàn)為:


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

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號