The reStructuredText markup language

Though several markup language options exist, the Python community tends to prefer reStructuredText (RST). The reStructuredText markup language is part of the Python Docutils project, located at http://docutils.sourceforge.net. The Docutils project develops the RST standard and provides utilities for converting RST to formats like PDF, ODT, HTML, and LaTeX.

Document structure

RST is geared toward the creation of structured documents; as such, the first thing we should create is a title for our document. This is denoted using a line of symbols above and below a single line of text, like so:

=========================
The reStructuredText saga
=========================

In this case, we've used the equals sign on either side of the title to denote it as our document title. We can also add a subtitle by adding another line underlined with a different symbol:

=========================
The reStructuredText saga
=============...