Section header 1: # with overline, for parts
Section header 2: * with overline, for chapters
Section header 2: = for sections
Section header 3: - for subsections
Section header 4: ^ for subsubsections
Section header 5: ” for paragraphs
The paragraph is the most basic block in a reST document. Paragraphs are simply chunks of text separated by one or more blank lines. As in Python, indentation is significant in reST, so all lines of the same paragraph must be left-aligned to the same level of indentation.
The standard reST inline markup is quite simple: use one asterisk: *text* for emphasis (italics), two asterisks: **text** for strong emphasis (boldface), and backquotes: `text` for code samples.
Documentation for Python’s standard library, along with tutorials and guides, are available online.
Replacements
file-code f1c8
file-video f1c9
play-circle f144
youtube f167
wikipedia-w f266
Tables
Grid table
https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#grid-tables
A0 |
B0 |
C0 |
|---|---|---|
A1 + B1 + C1 |
||
A2 |
B2 + C2 |
|
A3 |
B3 |
C3 |
List table
A0 |
B0 |
C0 |
|---|---|---|
A1 |
B1 |
C1 |
A2 |
B2 |
C2 |
A3 |
B3 |
C3 |
Lists
Bulleted lists: *
This is a bulleted list.
It has two items, the second item uses two lines.
Numbered lists: 1.
This is a numbered list.
It has two items too.
Autonumbered lists: #
This is a numbered list.
It has two items too.
Definition lists
- term (up to a line of text)
Definition of the term, which must be indented
and can even consist of multiple paragraphs
- next term
Description.
Images
Caption
One
Two
Koyaanisqatsi (1982)
Godfrey Reggio (D, W)
IMDb, RT, https://www.qatsi.org
- class veryspecial
- class specialllll
This is a “speciallll” paragraph.
- exceptional remarkable
An Exceptional Section
This is an ordinary paragraph.
- class multiple
First paragraph.
Second paragraph.
bullet list
- classy item
second item, with class argument
Another test
Peter Knobloch
This is a testtt
Containers
Some text
Visual lists
Koyaanisqatsi (1984)
Godfrey Reggio (D, W)
IMDb, RT, https://www.qatsi.org