Expert Python Programming - Third Edition

Section structure

The document's title and its sections are underlined using non-alphanumeric characters. They can be overlined and underlined, and a common practice is to use a double markup for the title and keep a simple underline for the section headings.

The most used characters to underline a section title are in the following order of precedence: =, -, _, :, #, +, and ^.

When a character is used for a section, it is associated with its level and it has to be used consistently throughout the document.

Consider the following code, for example:

============== Document title ============== Introduction to the document content. Section 1 ========= First document section with two subsections. Note the ``=`` used as heading underline. Subsection ...