Explizite Markup-Blöcke

Als explizite Markup-Blöcke werden in reStructuredText Textblöcke bezeichnet,

deren erste Zeile mit zwei Punkten gefolgt von einem Leerzeichen beginnt („expliziter Markup-Start“)
deren zweite und nachfolgende Zeilen (falls vorhanden) relativ zur ersten eingerückt sind
die vor einer nicht eingerückten Zeile enden

Prinzip

+-----+-----------------+ |".. "|explicit markup | +-----+ block | | | +-----------------+

Zwischen expliziten Markup-Blöcken und anderen Textkörperelementen (z. B. einem vorangehenden Absatz mit Text) ist eine Leerzeile notwendig. Eine Leerzeile zwischen expliziten Markup-Blöcken ist optional.

Beispiel:

Paragraph

.. [1] Body elements
.. [2] Body elements

Verwendung

Explizite Markup-Blöcke werden für folgende Konstrukte verwendet:

Verwendung	Beispiel
Interne Hyperlink-Ziele	.. _target:
Externe Hyperlink-Ziele	.. _target: http://www.beckhoff.de
Indirekte Hyperlink-Ziele	.. _target: hyperlink-reference_
Anonyme Hyperlink-Ziele	.. __: Anonymous-hyperlink-target
Manuell nummerierte Fußnoten	.. [1] Body elements
Automatisch nummerierte Fußnoten	.. [#] Body elements
Automatische Generierung von Symbolen für Fußnoten	.. [*] Body elements
Zitat (Ziel)	.. [CIT] Citation
Substitutionsdefinition	.. \|ref\| type: definition
Interne Kommentare	.. comment

Explizite Markup-Blöcke mit weiteren Eigenschaften:

Direktiven