Escaping-Mechanismus

Der für Klartextdokumente allgemein verfügbare Zeichensatz ist begrenzt. So können einzelne Markup-Zeichen im geschriebenen Text bereits eine Bedeutung haben und im Text erscheinen, ohne dass sie als Markup gedacht sind. Um die Standardbedeutung der für die Markup verwendeten Zeichen zu erhalten, gibt es in reStructuredText einen Escaping-Mechanismus. Als Escape-Zeichen wird ein Backslash („\“) verwendet.

Es gilt:

• Ein Backslash gefolgt von einem beliebigen Zeichen (außer Leerzeichen in Nicht-URI-Kontexten) bewirkt, dass das Zeichen das Zeichen selbst repräsentiert und bei der Interpretation von Markups keine Rolle spielt. Der Backslash wird aus der Ausgabe entfernt.
• Ein buchstäblicher Backslash wird durch zwei Backslashes in einer Reihe dargestellt.
• In Nicht-URI-Kontexten wird ein Backslash gefolgt von einem Leerzeichen aus dem Kommentar entfernt. Dies ermöglicht eine Inline-Markierung auf Zeichenebene (siehe Inline-Markup auf Zeichenebene).

• Es gibt zwei Kontexte, in denen Backslashes keine besondere Bedeutung haben: Codeblöcke und Inline-Literale. In diesen Kontexten stellt ein einzelner Backslash einen buchstäblichen Backslash dar, ohne dass er verdoppelt werden muss (siehe Codeblock).