Simple and more complex markup

reStructuredText includes simple and more complex markups. In contrast to simple markups, more complex markups can contain any text.

Without markup:

Use

Markup

Sample

Text blocks (paragraphs)

-

Paragraph

Simple markups are used for the following constructs:

Use

Markup

Sample

Indented text block (block quote)

Simple indentation

Paragraph

    Block quote

Line-oriented text block (line block)

Vertical bar

| Line block

Unordered enumeration list

Bullets

- Item

Ordered enumeration list

Enumerator

1. Item

Simple table

Horizontal bars

========
Column 1
========
Line 1
--------

Grid table

Horizontal and vertical bars

+----------+
| Column 1 |
+==========+
| Line 1   |
+----------+

More complex markups are used for the following constructs:

Use

Markup

Sample

Definition list

Any text followed by a colon and indentation

Term 3 : classifier
    Definition 3

Field list

Any text enclosed by colons

:Organization: Beckhoff Automation GmbH & Co. KG