For general notes on reStructuredText (RST) formatting see:
There are various editors available with RST support, such as Visual Studio Code with the reStructuredText plugin.
Notes on less obvious formatting methods are provided below.
Linking to other project documentation
While it’s possible to link to the documentation for another project just as you would a regular website, it’s better to use Intersphinx where this is also Sphinx-based. Benefits include that you can then use a shorter cross-reference role each time, rather than a full URL, as well there being just one place to update the mapping should the host or URL path on the server change. For details, see:
If the target Sphinx project has not previously been linked to, it will likely be
neccessary to update
conf.py in the project you would like to link from,
in order to add a new Intersphinx mapping.
Subscript and Superscript
Subscript and superscript characters can be generated using the
:sup: roles. For example:
Upper limit 10\ :sup:`6`. See note\ :sub:`2`.
Upper limit 106. See note2.
Interpreted text needs to be surrounded by whitespace or punctuation, which
means that if we don’t want a gap, e.g. between
6, or between
2, we need to escape the whitespace with a backslash.
Non-ASCII characters can be inserted by using substitutions and these are
defined in the file
substitutions.txt in the root of the Sphinx project.
For example, the right arrow (→) is inserted by entering
|rarr|. If a
character is not currently supported, simply look up the Unicode ID and add it