markdown - 如果在 ReadTheDocs 中使用 Markdown，我可以更改目录吗？

Question

我了解在使用Sphinx时可以使用TOC 指令编辑目录（即排序元素、使用子节点等）。

使用 Markdown 时可以实现这一点吗？

Answer 1

是的，它需要一些修改，但是，它应该可以完成工作。

查看https://github.com/rtfd/recommonmark以获取说明。

要进一步详细说明，您需要通过 pip install recommonmarkpip install recommonmark

然后，在您的conf.py文件中，您需要添加以下内容：

from recommonmark.parser import CommonMarkParser

source_parsers = {
    '.md': CommonMarkParser,
}

source_suffix = ['.rst', '.md']

来源并查看它的实际效果：http ://recommonmark.readthedocs.org/en/latest/