You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
24 lines
815 B
24 lines
815 B
4 years ago
|
////
|
||
|
|
Included in:
|
||
|
|
|
||
|
|
- user-manual: Text Substitutions: Preventing substitutions
|
||
|
|
- writers-guide: preventing subs
|
||
|
|
////
|
||
|
|
|
||
|
|
Asciidoctor provides several approaches for preventing substitutions.
|
||
|
|
|
||
|
|
.Backslash escaping
|
||
|
|
// tag::backslash[]
|
||
|
|
To prevent punctuation from being interpreted as formatting markup, precede it with a backslash (`\`).
|
||
|
|
If the formatting punctuation begins with two characters (e.g., `+__+`), you need to precede it with two backslashes (`+\\+`).
|
||
|
|
This is also how you can prevent character and attribute references from substitution.
|
||
|
|
When your document is processed, the backslash is removed so it doesn't display in your output.
|
||
|
|
|
||
|
|
[source]
|
||
|
|
----
|
||
|
|
include::ex-subs.adoc[tag=slash]
|
||
|
|
----
|
||
|
|
|
||
|
|
// end::backslash[]
|
||
|
|
You can also prevent substitutions with <<user-manual#passthroughs,macro and block passthroughs>>.
|