特殊字符替换步骤会搜索三个字符(<、>、&),并将它们替换为它们的命名字符引用。

  • 小于号符号“<”被替换为命名字符引用“<”。

  • 大于符号 > 被替换为命名字符引用 >。

  • 一个和号,&,会被替换为命名字符引用 &amp;。

默认特殊字符替换

'''块级元素和行内元素受到特殊字符替换的影响。 列出了特殊字符替换步骤自动应用于的特定块元素和行内元素。'''

Table 1. 块级元素和行内元素受到特殊字符替换的影响。
块和元素 默认应用的替换步骤

属性条目值

Yes

注释

No

示例

Yes

头部

Yes

文字、列表和源码

Yes

宏

Yes
(除了三重加号和内联通道宏)

开放

Yes

段落

Yes

直通块

No

引用和诗歌

Yes

侧边栏

Yes

表格

Yes

标题

Yes

特殊字符替换值

特殊字符替换步骤可以在块元素和行内元素上修改。对于块元素,步骤的名称`specialchars`可以分配给subs属性。对于行内元素,内置值`c`或`specialchars`可以应用于行内文本,以添加特殊字符替换步骤。

Note

特殊字符替换先于属性替换进行,因此你需要手动转义在CLI或API中设置的包含特殊字符的任何属性。例如,在命令行中,输入 -a toc-title="章节, 表格 \&amp; 图表" 而不是 -a toc-title="章节, 表格 & 图表"。