reST comes in docutils, a package that provides a suite of scripts to transform a reST file into various formats, such as HTML, LaTeX, XML, or even S5, Eric Meyer's slide show system (refer to http://meyerweb.com/eric/tools/s5).
Here's a sample of such a document:
===== Title ===== Section 1 ========= This *word* has emphasis. Section 2 ========= Subsection :::::::::: Text.
Writers can focus on the content and then decide how to render it, depending on their needs. For instance, Python itself is documented in reST, which is then rendered in HTML and various other formats. You can visit the official Python documentation via http://docs.python.org.
The minimum elements you should know to start writing reST are these:
- Section structure
- Lists
- Inline markup
- Literal block
- Links
This section is a really quick overview of the syntax...