======================= ReStructuredText Syntax =======================

Headings (2nd level) ==================== Section titles are underlined or overlined and underlined. The top level heading must have an overline and underline equal to the length of the heading. Subsequent lower level headings may use any recommended character as an underline in any order. The order enforced will be the order as encountered.

Any of the following characters are recommended for section headings::

• = - ` : . ' " ~ ^ _ * + #

heading 3rd level

heading 4th level ~~~~~~~~~~~~~~~~~

heading 5th level +++++++++++++++++

heading 6th level .................

Text Formatting ===============

===================== ====================

• Markup Result

===================== ====================

• *italic* *italic* **bold** **bold**

===================== ====================

Internal Links ==============

===================================== ================================

• Markup Result

===================================== ================================

• Item Item Item/SubItem Item/SubItem /SubItem /SubItem ../SiblingItem ../SiblingItem named link named link #anchorname #anchorname description description Item#anchorname Item#anchorname description description

===================================== ================================

External Links ==============

Blockquotes and Indentations ============================

Indentations in ReST are called *Transitions*.

• To indent test start a line with one or more blanks
  • Text indented to the 2nd level has more leading blanks than the first level. To continue indentation, use the same number of leading blanks. To start a second indented paragraph, insert a blank line.

Lists =====

Unordered Lists

• The first item in a list must be preceded with a blank line
• Bullets can be "*", "+", or "-"
  • + To start sub-level, insert a blank line
    • - sub-sub level
• item 3
• item 4

Ordered Lists

The first item of an ordered list should be "1", "A", "a", "I", or "i". To auto-enumerate, use "#" for the subsequent list items.

1. item 1 #. item 2 #. item3
   1. sub-item A)

      #. sub-item

      1. sub-sub item I #. sub-sub item II

Definition Lists

term

definition

object

description 1

description 2

Horizontal Rules ================

Tables ======

There are two types of tables, grid and simple. To use grid tables, you must paint the cells of the table using "+", "-", "|", and "=" characters.

+

+

+

+ | 1 | 2 | 3 | +

+

+

+

+

+

+

+ | 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. | +

+

+

+

To create simple tables, use "=" characters to define the width of the cells with a row.

===== ===== ======

• Inputs Output

• A B A or B

===== ===== ====== False False False True False True False True True True True True ===== ===== ======

===== ===== ======= A B A and B ===== ===== ======= False False False True False False False True False True True True ===== ===== =======

Smileys and Icons =================

Admonitions ===========

Comments ========