This is a header.

Title

Subtitle

Table of Contents

1   Markup

1.1   Lists

1.1.1   Bullet List

  • first
  • second
  • third

1.1.2   Enumerated Lists

  1. first
  2. second
  3. third
  1. first
  2. second
  3. third

1.1.3   Definition List

term 1
Definition 1.
term 2

Definition 2, paragraph 1.

Definition 2, paragraph 2.

term 3 : classifier
Definition 3.
term 4 : classifier one : classifier two
Definition 4.

1.1.4   Field List

Date:

2001-08-16

Version:

1

Authors:
  • Me
  • Myself
  • I
Indentation:

Since the field marker may be quite long, the second and subsequent lines of the field body do not have to line up with the first line, but they must be indented relative to the field name marker, and they must line up with each other.

Parameter i:

integer

1.1.5   Option List

-a Output all.
-b Output both (this description is quite long).
-c arg Output just arg.
--long Output all day long.
-p

This option has two paragraphs in the description. This is the first.

This is the second. Blank lines may be omitted between options (as above) or left in (as here and below).

--very-long-option
 A VMS-style option. Note the adjustment for the required two spaces.
--an-even-longer-option
 The description can also start on the next line.
-2, --two This option has two variants.
-f FILE, --file=FILE
 These two options are synonyms; both have arguments.
/V A VMS/DOS-style option.

1.2   Tables

1.2.1   Simple Table

A B A and B
False False False
True False False
False True False
True True True
Inputs Output
A B A or B
False False False
True False True
False True True
True True True

1.2.2   Grid Table

Header row, column 1 (header rows optional) Header 2 Header 3 Header 4
body row 1, column 1 column 2 column 3 column 4
body row 2 Cells may span columns.
body row 3 Cells may span rows.
  • Table cells
  • contain
  • body elements.
body row 4

1.3   Misc

1.3.1   Footnotes

[1]Body elements go here.

1.3.2   Citation

Here is a citation reference: [CIT2002].

[CIT2002]This is the citation. It's just like a footnote, except the label is textual.

1.3.4   Inline Literal

inline literal

1.3.5   Literal Block

This is a typical paragraph. An indented literal block follows.

for a in [5,4,3,2,1]:   # this is program code, shown as-is
    print a
print "it's..."
# a literal block continues until the indentation ends

This text has returned to the indentation of the first paragraph, is outside of the literal block, and is therefore treated as an ordinary paragraph.

1.3.6   Quoted Literal Blocks

John Doe wrote:

>> Great idea!
>
> Why didn't I think of that?

You just did! ;-)

1.3.7   Line Block

Take it away, Eric the Orchestra Leader!

A one, two, a one two three four

Half a bee, philosophically,
must, ipso facto, half not be.
But half the bee has got to be,
vis a vis its entity. D'you see?

But can a bee be said to be
or not to be an entire bee,
when half the bee is not a bee,
due to some ancient injury?

Singing...

1.3.8   Block Quote

This is an ordinary paragraph, introducing a block quote.

"It is my business to know things. That is my trade."

—Sherlock Holmes

1.3.9   Doctest Block

This is an ordinary paragraph.

>>> print 'this is a Doctest block'
this is a Doctest block

The following is a literal block:

>>> This is not recognized as a doctest block by
reStructuredText.  It *will* be recognized by the doctest
module, though!

2   Directives

2.2   Admonitions

2.2.1   Attention

Attention!

Beware killer rabbits!

2.2.2   Caution

Caution!

Beware killer rabbits!

2.2.3   Danger

!DANGER!

Beware killer rabbits!

2.2.4   Error

Error

Beware killer rabbits!

2.2.5   Hint

Hint

Beware killer rabbits!

2.2.6   Important

Important

Beware killer rabbits!

2.2.7   Note

Note

Beware killer rabbits!

2.2.8   Tip

Tip

Beware killer rabbits!

2.2.9   Warning

Warning

Beware killer rabbits!

2.3   Images

2.3.2   Figure

map to buried treasure

This is the caption of the figure (a simple paragraph).

The legend consists of all elements after the caption. In this case, the legend consists of this paragraph.

2.4   Body Elements

2.4.1   Topic

Topic Title

Subsequent indented lines comprise the body of the topic, and are interpreted as body elements.

2.4.4   Code

def my_function():
    "just a test"
    print 8/2

2.4.5   Math

αt(i) = P(O1, O2, …Ot, qt = Siλ)

2.4.6   Rubric

Some Heading

2.4.7   Epigraph

No matter where you go, there you are.

—Buckaroo Banzai

2.4.8   Highlights

  • one
  • two
  • three

2.4.9   Pull-Quote

This is a pull-quote

2.4.10   Compound Paragraph

The 'rm' command is very dangerous. If you are logged in as root and enter

cd /
rm -rf *

you will erase the entire contents of your file system.

2.4.11   Container

This paragraph might be rendered in a custom way.

2.5   Tables

2.5.1   Table

Truth table for "not"
A not A
False True
True False

2.5.2   CSV-Table

Frozen Delights!
Treat Quantity Description
Albatross 2.99 On a stick!
Crunchy Frog 1.49 If we took the bones out, it wouldn't be crunchy, now would it?
Gannet Ripple 1.99 On a stick!

2.5.3   List Table

Frozen Delights!
Treat Quantity Description
Albatross 2.99 On a stick!
Crunchy Frog 1.49 If we took the bones out, it wouldn't be crunchy, now would it?
Gannet Ripple 1.99 On a stick!

2.7   Misc

And another: google2 [3] with a footnote: [2]

Topic Title

Subsequent indented lines comprise the body of the topic, and are interpreted as body elements.

[3](1, 2) http://www.google.com/