Headers

標題(或章節)由下劃線(有時也包含上劃線)來組成。

組合標題(或章節)的字元如下：

= - ` : . ' " ~ ^ _ * + #

這些都是合法字元。

通常沒有規定標題(或章節)的層級樣式，不過，對於Python文檔，可以由如下規定：

  • # 配合上劃線，代表”篇”(parts)
  • * 配合上劃線，代表”章節” (chapter)
  • = 代表小節
  • - 代表子小節
  • ^ 代表子子小節
  • " 代表段落

Header 的樣式如下：

############
H1 -- 標題
############

***********
H2 -- 標題
***********

H3 -- 標題
==========

H4 -- 標題
----------

demo:

../_images/header.png

Note

H1標題的樣式只能每頁使用一次，這在轉換成pdf時，被視成”章節”。