reStructuredText

Section header level

任何 non-alphanumeric characters = - ` : ' " ~ ^ _ * + # < > 都可以作为 section header。官方推荐的顺序 1 如下:

Chapter 1 Title
===============

Section 1.1 Title
-----------------

Subsection 1.1.1 Title
~~~~~~~~~~~~~~~~~~~~~~

Section 1.2 Title
-----------------

Chapter 2 Title
===============
1

https://docutils.sourceforge.io/docs/user/rst/quickstart.html#structure