render.txt

text:
.
some text
.
some text
.

emphasis:
.
*emphasis*
.
*emphasis*
.

strong:
.
**strong**
.
**strong**
.

literal:
.
``abc``
.
`abc`
.

literal block:
.
::

   literal text

normal text
.
```
literal text
```

normal text
.

doctest block [EXPECT_WARNING]:
.
This is an ordinary paragraph.

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

Another paragraph
.
This is an ordinary paragraph.

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

Another paragraph
.

block quotes
.
a

    b

    -- attribution

        nested

    - with
    - bullet list

    1. with
    2. enumerated list

c
.
a

> b
>
> <p class="attribution">-attribution</p>

> > nested
>
> - with
> - bullet list
>
> 1. with
> 2. enumerated list

c
.

transition:
.
----
.
______________________________________________________________________
.

headings:
.
heading 1
=========

heading 2-1
-----------

heading 3
*********

heading 2-2
-----------
.
# heading 1

## heading 2-1

### heading 3

## heading 2-2
.

bullet-list:
.
- a
- b
- c

* d

  * e
  * f

* g
.
- a
- b
- c

* d

  - e
  - f

* g
.

enumerated list:
.
1. a
2. b
3. c

#. d
#. e

11. f
12. g
.
1. a
2. b
3. c
4. d
5. e

11) f
12) g
.

comment:
.
.. This is a comment.

..
   This whole indented block
   is a comment.

   Still in the comment.

.
% This is a comment.

% This whole indented block
% is a comment.
%
% Still in the comment.
.

autolink:
.
http://a.net/
.
<http://a.net/>
.

external link:
.
`Link text <https://domain.invalid/>`_
.
[Link text](https://domain.invalid/)
.

external link definition:
.
This is a paragraph that contains `a link`_.

.. _a link: https://domain.invalid/
.
This is a paragraph that contains [a link].

[a link]: https://domain.invalid/
.

internal link, no-definition
.
`a link`_ `text <a link>`_
.
[a link] [text](alink)
.

link definition only
.
.. _a link: https://domain.invalid/
.
[a link]: https://domain.invalid/
.

target:
.
.. _a:

ab
==
.
(a)=

# ab
.

footnote:
.
[1]_ [#]_ [*]_

.. [1] normal footnote
   next line
.. [#] auto-number footnote.
.. [*] auto-symbol footnote.
.
[^footnote-1] [^footnote-2] [^footnote-3]

[^footnote-1]: normal footnote
    next line

[^footnote-2]: auto-number footnote.

[^footnote-3]: auto-symbol footnote.
.

citation:
.
[a]_

.. [a] citation footnote
   next line

   new paragraph
.
[^cite_a]

[^cite_a]: citation footnote
    next line

    new paragraph
.

roles:
.
`a` :b:`c`
.
`a` {b}`c`
.

table, simple:
.
== ==
A  B
== ==
C  D
== ==
.
| A   | B   |
| --- | --- |
| C   | D   |
.

table, nested syntax:
.
===== =============
*A*   http://a.net/
===== =============
``C`` [1]_
===== =============

.. [1] footnote
.
| *A* | <http://a.net/> |
| --- | --------------- |
| `C` | [^footnote-1]   |

[^footnote-1]: footnote
.

tables-grid:
.
+------------------------+------------+----------+----------+
| Header row, column 1   | Header 2   | Header 3 | Header 4 |
| (header rows optional) |            |          |          |
+========================+============+==========+==========+
| body row 1, column 1   | column 2   | column 3 | column 4 |
+------------------------+------------+----------+----------+
| body row 2             | ...        | ...      |          |
+------------------------+------------+----------+----------+

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

para
.

table, multi-head:
.
== ==
A  B
X  Y
== ==
C  D
== ==
.
```{eval-rst}
== ==
A  B
X  Y
== ==
C  D
== ==
```
.

front-matter:
.
:Authors:
    Tony J. (Tibs) Ibbs,
    David Goodger

    (and sundry other good-natured folks)

:Version: 1.0 of 2001/08/08
:Dedication: To my father.
:orphan:
.
---
Authors: |-
  Tony J. (Tibs) Ibbs,
  David Goodger

  (and sundry other good-natured folks)
Dedication: To my father.
Version: 1.0 of 2001/08/08
orphan: true
---
.

substitution-reference:
.
|sub|
.
{{ sub }}
.

substitution-definition:
.
:orphan:

.. |name| replace:: replacement `a`_

.. |caution| image:: warning.png
             :alt: Warning!
.
---
orphan: true
substitutions:
  caution: |-
    ```{image} warning.png
    :alt: Warning!
    ```
  name: replacement [a]
---
.

definition list
.
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 ``a`` `a`_.
.
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 `a` [a].
.

directive-eval-rst
.
.. unknown:: argument

.. xyz::
  :opt: value

.. lmp::

   content

   .. sdf::

      other

.. hij:: argument
    :opt: value1
    :opt2: value2

.. hij:: argument
    :opt: value1
    :opt2: value2

    ````content````

.
```{eval-rst}
.. unknown:: argument
```

```{eval-rst}
.. xyz::
  :opt: value
```

```{eval-rst}
.. lmp::

   content

   .. sdf::

      other
```

```{eval-rst}
.. hij:: argument
    :opt: value1
    :opt2: value2
```

`````{eval-rst}
.. hij:: argument
    :opt: value1
    :opt2: value2

    ````content````
`````
.

directive-admonition:
.
initial paragraph

.. admonition:: Abc *d* `a`_
   :class: xyz
   :name: df

   A *b* http://a.net/

   next paragraph

.. note::

    .. tip::

        Content

        .. note::

            Content 2

    .. unknown:: arg_block

        content

final paragraph
.
initial paragraph

:::{admonition} Abc *d* [a]
:class: xyz
:name: df

A *b* <http://a.net/>

next paragraph
:::

:::::{note}

::::{tip}
Content

:::{note}
Content 2
:::
::::

```{eval-rst}
.. unknown:: arg_block

    content
```
:::::

final paragraph
.

field-list
.
paragraph

:name: value
:other: multiline
    value
    more

paragraph
.
paragraph

```{eval-rst}

:name: value
:other: multiline
    value
    more
```

paragraph
.

dollarmath
.
:math:`a^2 + b^2 = c^2`
.
$a^2 + b^2 = c^2$
.

code-block-no-args
.
.. code-block:: python

   def some_function():
       interesting = False
       print 'This line is highlighted.'
       print 'This one is not...'
       print '...but this one is.'

.. code-block:: yaml

    a: 1
    b: "a"
.
```python
def some_function():
    interesting = False
    print 'This line is highlighted.'
    print 'This one is not...'
    print '...but this one is.'
```

```yaml
a: 1
b: "a"
```
.