Bulleted Lists

Look at these bullets

* First bullet
* Second bullet

  * First sub-bullet
  * Second sub-bullet

produces

Look at these bullets

• First bullet
• Second bullet
  • First sub-bullet
  • Second sub-bullet

Note that a newline between indentation levels as well as two spaces of indentation are required for the wiki formatter to properly format bulleted lists.

Numbered Lists

#. Top level
#. Second level

  #. Top sub-level
  #. Second sub-level

#. Numbering re-starts here

produces

1. Top level
2. Second level

1. Top sub-level
2. Second sub-level

1. Numbering re-starts here

A more intuitive sub-level numbering might be a., b., c., etc., but this does not seem to work. Also unclear is why numbering restarts when resuming the initial level of indentation.

Sections

Please see the section titled Sections/Headers further down the page

Footnotes

Info is forthcoming.

Literal Blocks

To produce blocks of code, type a paragraph containing only colons (::). All text that is indented below the colons will be formatted as monospace text with markup and whitespace preserved. The literal block ends once text returns to the preceding paragraph's indentation, as shown by the following:

This is a normal paragraph.  Down below it will be a block of code.

::

  This text should be *preserved* with
   all spacing and white space.

    It is useful for entering blocks
         of code.

We're back to normal formatting now. Wow that was a nice block of code!

produces:

This is a normal paragraph. Down below it will be a block of code.

This text should be preserved with
 all spacing and white space.

  It is useful for entering blocks
       of code.

We're back to normal formatting now. Wow that was a nice block of code!

Line Breaks

Useful for formatting addresses and the such:

| Grameen Technology Center
| 909 NE Boat Street, Suite 300
| Seattle, WA 98105

produces

Horizontal Rule

A string of four consecutive symbols (-), (+), (*), (~) will produce a horizontal line to divide sections of text.

----

produces:

list-tables

.. list-table:: Sample table
   :widths: 10 50
   :header-rows: 1

   * - Row #
     - Description
   * - Row 1
     - Here is a long row.
   * - Row 2
     - Here is another long row.
   * - Row 3
     - Each new row is started with an '*', each new column with a '-'.
   * - Row 4
     - By adjusting the width initially I can control the length of each row.

produces

csv-tables

These are simple tables (cell cannot span across multiple rows) yet are easier to create than the formats below.

.. csv-table:: Table Name
   :header: "Column One", "Column Two", "Column Three"
   :widths: 20, 10, 30

   "Text goes here", 15.85, "Enter it now!"
   "interesting row", 21.47, "indeed."
   "Look an empty cell", 19.34, " "

produces

Further information on the csv-table and other directives within reStructured Text can be found here

Complex but Clunky Tables

+------------+------------+-----------+
| Header 1   | Header 2   | Header 3  |
+============+============+===========+
| body row 1 | column 2   | column 3  |
+------------+------------+-----------+
| body row 2 | Cells may span columns.|
+------------+------------+-----------+
| body row 3 | Cells may  | - Cells   |
+------------+ span rows. | - contain |
| body row 4 |            | - blocks. |
+------------+------------+-----------+

produces:

Simple but limited tables

=====  =====  ======
   Inputs     Output
------------  ------
  A      B    A or B
=====  =====  ======
False  False  False
True   False  True
False  True   True
True   True   True
=====  =====  ======

produces:

Table of Contents

• These Sections/Headers are implicit targets (anchors) so to link to a Section you would simply type, `Inline Markup`_ to produce a link the Inline Markup section at the top of this page:

• A Table of Contents can also be auto-generated from these Sections/Headers using the following directive at the top of the page (above all headers):

.. Contents::

• To rename the table of contents you would type the following:

.. Contents:: Named Table of Contents

• To select how many levels deep you want the Table of Contents to display, you would enter the following (in this example 2 levels deep):

.. Contents::
  :depth: 2

Auto-Section Numbering

To generate sections and sub-sections that are autonumbered (1, 1.1, 1.1.1) you can use the sectnum directive.

At the top of the page type ".. sectnum::" and your sections will be auto-numbered in the manner described above.

For an example of auto-numbered sections, please look here.

• For more on other powerful features capable with directives, please visit reStructured Text Directives