Headings¶
In reStructuredText (reST), headings are represented using different symbols. The type of symbol used determines the level of the heading. The length of the symbol line should typically match or exceed the length of the heading text.
Common symbols used for headings are =, -, ~, ^, and “.
Note
In the case of Chinese characters, which count as two normal characters, you should ensure that the number of symbols is greater than the length of the heading, but an exact match is not necessary.
Basic Usage¶
Here are examples illustrating different heading levels:
Level 1 Heading
===========================
Level 2 Heading
---------------------------
Level 3 Heading
~~~~~~~~~~~~~~~~~~~~~~~~~
Level 4 Heading
^^^^^^^^^^^^^^^^^^^^^^^
Explanation of heading levels:
Level 1 Heading uses the = symbol.
Level 2 Heading uses the - symbol.
Level 3 Heading uses the ~ symbol.
Level 4 Heading uses the ^ symbol.
This system of headings provides a clear hierarchy for organizing content, making it easier for readers to navigate the document.