Markdown MkDocs-如何在index.md内从MkDocs.yml创建目录_Markdown_Mkdocs

Markdown MkDocs-如何在index.md内从MkDocs.yml创建目录

markdown

Markdown MkDocs-如何在index.md内从MkDocs.yml创建目录,markdown,mkdocs,Markdown,Mkdocs,我正在寻找一种在.md文件中自动包含TOC的方法。这听起来很琐碎，在GitBook和其他静态网站生成器中很早就有了有任何扩展支持它吗？开箱即用，没有，MkDocs无法将任何信息传递到页面的标记文本中。然而，这是可能的，有一个简单的方法。您可以找到已知插件的列表。不幸的是，该列表中似乎没有任何插件将全局导航传递到页面的标记文本。然而，和插件将是一个很好的开始，因为它们都将其他信息传递给标记文本为了实现完整性，请注意MkDocs同时具有全局导航和目录。我假设您所说的是全局导航，正如您所指出的，它

我正在寻找一种在

.md

文件中自动包含TOC的方法。这听起来很琐碎，在GitBook和其他静态网站生成器中很早就有了

有任何扩展支持它吗？

开箱即用，没有，MkDocs无法将任何信息传递到页面的标记文本中。然而，这是可能的，有一个简单的方法。您可以找到已知插件的列表。不幸的是，该列表中似乎没有任何插件将全局导航传递到页面的标记文本。然而，和插件将是一个很好的开始，因为它们都将其他信息传递给标记文本

为了实现完整性，请注意MkDocs同时具有全局导航和目录。我假设您所说的是全局导航，正如您所指出的，它是否应该来自

index.yml

。相反，TOC是特定于页面的。每一页都有自己的TOC，即该页上的标题列表。MkDocs利用了对Python标记的扩展，其中包括对在页面中插入特定于页面的TOC的支持。只需将文本

[TOC]

插入标记文本中的任意位置，TOC就会插入其中