如何为AsciiDoctor-pdf输出的标题添加背景色？

你可以通过调整主题配置中的背景色属性和内边距来实现红色背景搭配黑色文字的需求，具体配置如下：

extends: default
...

heading:
  h2-font-color: #000000  # 设置标题文字为黑色
  h2-font-family: ArialBlack
  h2-font-style: normal
  h2-font-size: 13
  h2-background-color: #FF0000  # 设置红色背景
  h2-padding: [5, 10, 5, 10]  # 上、右、下、左内边距，避免文字与背景/边框重叠
  # 若需要保留边框可保留以下配置，不需要则删除
  h2-border-width: [1, 1, 1, 1]
  h2-border-color: #FF0000

关键说明： #

• h2-background-color是Asciidoctor PDF主题支持的属性，之前无效大概率是配置层级错误（未放在heading节点下）或属性名拼写问题。
• 必须添加h2-padding属性，为标题文字留出足够空间，避免文字被背景或边框遮挡。
• 将h2-font-color改为#000000（黑色），配合红色背景保证文字清晰可读。

若配置仍不生效，检查你的Asciidoctor PDF版本，较旧版本可能对部分属性支持有限，建议升级至最新稳定版。

内容的提问来源于stack exchange，提问作者Husky