reStructuredText & Sphinx

This chapter is a reference for writing documentation using reStructuredText (also referred to as reST) and Sphinx.

It is recommended to read (or at least browse through) the Introduction and the general Coding Guidelines for reST Files first.

Also read Common Pitfalls in order to avoid common mistakes with the syntax or make sure to setup your editor or IDE correctly to detect and show errors in the syntax.

You don't need to read the entire chapter, just lookup the section that is relevant for what you plan to do.

Or, use the cheat-sheet, which contains the most commonly used markup on one page.

We won't be covering every reST and sphinx markup that is available. For more information, see Restructured Text (reST) and Sphinx CheatSheet

Tip

See the t3SphinxThemeRtd demo docs for more examples.