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