如何在 sphinx 中添加 html 标签？

Question

在 Doxygen 中，您可以在文档字符串中添加一个 html 标签，如下所示

"""!    
x<sub>1</sub>,
"""

会生成如下

它的样式表

sub {
  vertical-align: sub;
  font-size: smaller;
}

在 Sphinx 中可以做到吗？如果是这样，如何？ 它不需要在文档字符串中，它可以在第一个文件中的任何位置。

到目前为止我在我的第一个文件中尝试了什么

x<sub>1</sub>,
.. x<sub>1</sub>,

没有成功

我试图转义标签

x/<sub>1/</sub>,

再次失败

我确定我在这里错过了什么。

Answer 1

使用:subscript: role:

H\ :sub:`2`\ O

或

The chemical formula for pure water is |H2O|.

.. |H2O| replace:: H\ :sub:`2`\ O

您也可以使用 :raw:，但请注意它的警告。