如何在mkdocs中编写函数语法

Question

我需要写下什么语法的markdown来编写api，如下所示。

html代码如下：
link

<dl class="function">
<dt id="create_bootstrap_script">
<code class="descname">create_bootstrap_script</code><span class="sig-paren">(</span><em>extra_text</em><span class="sig-paren">)</span><a class="headerlink" href="#create_bootstrap_script" title="Permalink to this definition">¶</a></dt>
<dd><p>Creates a bootstrap script from <code class="docutils literal"><span class="pre">extra_text</span></code>, which is like
this script but with extend_parser, adjust_options, and after_install hooks.</p>
</dd></dl>

<p>This returns a string that (written to disk of course) can be used
as a bootstrap script with your own customizations. The script
will be the standard virtualenv.py script, with your extra text
added (your extra text should be Python code).</p>
<p>If you include these functions, they will be called:</p>

我尝试使用这样的语法，但结果就像是但不一样。

    Orange(a, b)
:   The fruit of an evergreen tree of the genus Citrus.

每个答案都将受到赞赏。

Answer 1

在第一个示例中，dt是一个已应用语法高亮的codespan。

在第二个示例中，dt仅包含纯文本。您也可以通过使用代码范围来接近：

`Orange(a, b)`
:   The fruit of an evergreen tree of the genus Citrus.

请注意，第一行包含在反引号（`）中，这使其成为代码范围。当然，您仍然需要语法高亮来获得完全匹配，但MkDocs目前不支持代码跨度的语法高亮，只支持代码块。据推测，virtualenv文档是使用Sphinx而不是MkDocs构建的。虽然MkDocs在外观上接近匹配Sphinx，但它与功能的功能不匹配，这是其中一个区别。也就是说，可以使用自定义主题和/或使用一些自定义Markdown Extensions。