创建一个包含参数的指令的 sphinx 扩展

我对编写 sphinx 扩展相对较新，并希望创建一个包含多个关键字的扩展，这些关键字与 rst 文档中的指令名称一起提供，并用一段 html 替换它。

docutils 中预定义的 list-table 指令允许这样做：

.. list-table::

   * - item1

     - item2
   
     - item3

到目前为止，我只看了provided helloworld example，它将指令关键字替换为字符串“Hello World”。

我的想法是在我想要插入的 html 旁边返回一个 .. raw:: html 标签。有什么好的解决办法吗？