为什么我的文档在 readthedocs 上没有锚定标题？

Question

我正在使用 mkdocs 从 Markdown 构建 hendrix 文档。

当显示在readthedocs 上时，文档没有标题的锚链接。

Answer 1

这不是 Markdown 的标准功能，因此不支持开箱即用。但是，您可以使用包含的 Markdown 扩展轻松启用它。在您的 config.yaml 文件中，包括以下内容：

markdown_extensions:
    - toc:
        permalink: True

如果您有兴趣，docs 会详细说明此设置。