现在使用conf.py更改主题会在导入时忽略目录树的my.md文件

Question

我正在从GitHub/gitbook移动一份技术文档，并在RTD上使用Sphinx，默认导入时，在为toctree创建的index.rst之外没有Sphinx文件，并且在RTD中使用默认设置。它工作正常，显示良好，外观比以前好得多，但颜色错误。当我在GitHub项目中添加conf.py for theme选项（使master查找索引）并重新构建到RTD时，构建成功，颜色很好，但现在忽略了我的.md文件，因此没有目录树内容。没有conf.py，我得到了一个很好的布局，但颜色不对

我觉得我已经尝试了所有方法，从返回基本conf.py到在目录树中留下一个空文件，我已经将文件ext改为.rst，它可以工作，但不能重新格式化.md。它似乎只是忽略了.md文件

*仅更改conf.py的以下代码，索引与工作时的文档相同

master_doc = 'index'
html_theme = "classic"
"rightsidebar": False,
"stickysidebar": True,
"collapsiblesidebar": True,
"externalrefs": True,
"footerbgcolor": 'white',
"footertextcolor ": 'darkslategrey',
"sidebarbgcolor": 'white',
"sidebarbtncolor": 'darkslategrey',
collapsiblesidebar is True).
"sidebartextcolor": 'darkgreen',
"sidebarlinkcolor":'green',
"relbarbgcolor": 'darkslategrey',
"relbartextcolor": 'white',
"relbarlinkcolor": 'white',
"bgcolor": 'white',
"textcolor": 'black',
"linkcolor": 'darkgreen',
"visitedlinkcolor": 'darkgreen',
"headbgcolor": 'white',*

我想要实现的就是导入我的.md文件，它们来自一个实时文档，并使用定制颜色的经典主题输出

任何能阻止我发疯的帮助都将不胜感激，我知道这是我自己的问题，而不是软件的问题

谢谢

Answer 1

谢谢，这对我有用，谢谢你的帮助

我还添加了扩展=['recommenmark']

Answer 2

您必须在conf.py中声明^{}：

source_suffix = {
    '.rst': 'restructuredtext',
    '.txt': 'restructuredtext',
    '.md': 'markdown',
}

您可能还需要安装和配置recommonmarkRTD supports it natively