AsciiDoc 语法提供了多种方法来防止应用替换。

使用反斜杠转义

为了防止标点符号被解释为属性引用或格式化语法(例如,_, ^)在普通内容中,可以在字符前加上反斜杠(\)。

在普通内容中使用反斜杠防止意外替换。
Unresolved directive in prevent.adoc - include::example$subs.adoc[tag=backslash]

反斜杠也可以防止字符替换、宏和属性替换。在普通内容中使用反斜杠防止意外替换。的结果如下。

Unresolved directive in prevent.adoc - include::example$subs.adoc[tag=backslash]

注意反斜杠被移除了,所以它不会显示在你的输出中。

为了防止两个相邻的字符(例如,__,##),被解释为AsciiDoc语法,你需要在其前面加上两个反斜杠(\\)。

在普通内容中使用两个反斜线来防止意外的替换
Unresolved directive in prevent.adoc - include::example$subs.adoc[tag=double-slash]

Unresolved directive in prevent.adoc - include::example$subs.adoc[tag=double-slash]

直通项

通过是AsciiDoc中用来转义内容的主要机制。它们比使用反斜杠更全面和一致。正如其名称所暗示的,通过直接将内容传递到输出文档而不应用任何替换。

你可以使用内联直通宏来控制和阻止内联文本中的替换,并且可以使用块直通来控制整个内容块的替换。