asciidoc 到 html 转换中行首的文字星号

Question

AsciiDoc source likea * a被转换为 HTML 作为普通文本“a * a”。如果星号是行中的第一个非空格字符，则它开始一个列表（这是正常的）。但是，我需要用文字星号开始一个段落。我尝试了以下方法来逃避它：

• `*`
  • *（内部渲染<code>）
• \*
  • \*（呈现为普通文本但存在反斜杠）
• +*+
  • *（内部渲染<code>）
• pass::[*]
  • 错误： block macro cannot occur here: pass::[*]
• '*'
  • *（在内部渲染<em>- 迄今为止最接近我需要的）

如何在 AsciiDoc 源代码的行首指定星号，使其在 HTML 输出中显示为普通文本？

Answer 1

事实证明，对于内联传递，需要不同形式的pass。我还检查了@Mario Lopez建议的解决方案。我总结了以下选项：

• 直通：
  • pass:[*]
  • +++*+++
  • $$*$$
• 打扰列表模式
  • {empty}*（常见问题解答中的“官方”解决方案）
  • *text
  • *{sp}
• HTML 转义
  • *
  • *

Answer 2

我知道你有两种选择。将其转换为列表的模式特别是一个星号后跟一个空格。

* item

它将像这样呈现：

• 物品

您可以省略空格或使用空格属性。

*item
*{sp}item

哪个会像这样（分别）呈现：

*项目
*项目

有关属性和替换的更多信息，请访问：http : //asciidoctor.org/docs/asciidoc-syntax-quick-reference/#attributes-and-substitutions