reStructuredText (reST)

reStructuredText (reST) is a document encoding format used primarily in the context of interspersing documentation with source code, especially in the Python ecosystem. As such, it offers greater control than markdown when it comes to programming-language specific details such as the documentation of input arguments and return values.

reST embraces the tenets of automated content generation and decoupled rendering by facilitating the production of documentation in various formats directly from source code.

reST can also be used to produce standalone documents. Notwithstanding its Python origins, it is not an obscure format. It is supported by GitHub and Bitbucket, among others. Also, similarly to asciidoc, it has syntactic support for paper-oriented use cases such as the inclusion of bibliographical references. The complete specification is here.

Example

=========================
This is a level 1 heading
=========================

This is a level 2 heading
=========================

This is text in **bold** and *italics*, and this is an external link to [DocOps](https://docops.guide). Now, some bullet points:

* Bullet point 1
* Bullet point 2
* Bullet point 3