自动创建索引的工具有哪些

在搭建网站时，尤其是内容较多的文档站或博客，手动维护目录和索引费时又容易出错。好在现在有不少工具能自动扫描文件结构、生成导航索引，省下大量重复劳动。

Docsify 是一个动态生成文档网站的工具，不需要构建过程。只要写好 Markdown 文件，它能在页面加载时自动解析并生成侧边栏目录。比如你有一个 docs 文件夹，里面按章节分了多个 md 文件，启动 Docsify 后会自动按文件夹结构生成可点击的左侧菜单。

<script>
  window.$docsify = {
    name: '我的文档',
    loadSidebar: true,  // 自动读取 _sidebar.md 或按目录生成
    auto2top: true
  }
</script>

如果没写 _sidebar.md，它会根据目录层级自动生成导航链接。

由 Facebook 推出的 Docusaurus 特别适合技术文档项目。初始化后，把 Markdown 或 MDX 文件放进 docs 目录，运行构建命令，它会自动分析文件顺序和标题，生成带层级的侧边栏。

还能通过 sidebars.js 配置自动生成规则，比如按字母排序、识别前置元数据控制显示顺序。

Hugo 是静态站点生成器里的“快枪手”。它支持自动从内容目录中提取页面信息，生成菜单和分类索引。比如你在 content/posts/ 下写了多篇博客，Hugo 会自动列出最新文章列表，无需手动添加链接。

配合主题使用时，很多都内置了自动索引功能，像显示标签云、按日期归档等，全靠配置文件驱动。

MkDocs 简洁易上手，专为项目文档设计。在 mkdocs.yml 中设置 nav: 字段为自动生成模式，保存后运行 mkdocs serve，它会扫描 docs/ 目录下的所有 Markdown 文件，并按文件名顺序生成顶部或侧边导航。

加上插件如 mkdocs-awesome-pages，还能实现隐藏某些页面、按子目录自动分组等功能。

VuePress 基于 Vue，适合需要定制交互的文档站。默认开启文件系统路由，/guide/ 目录下的每个 .md 文件都会变成对应页面。启用 sidebar: 'auto' 后，访问该路径时会自动提取当前目录下的文件标题作为侧边栏条目。

比如你新增了 performance.md，刷新页面就能看到新条目出现在导航中，不用改任何配置。

虽然老版 GitBook 已停更，但新版本基于开源工具链重建，依然支持通过 SUMMARY.md 自动生成目录。如果不写这个文件，也能用插件实现按目录结构自动发现内容并建立索引链接。

适合团队协作写文档，每次提交新章节后部署自动更新网站导航。

如果你用 Obsidian 写知识库，它的发布功能可以把笔记自动构建成公开网站。开启“自动生成图表”和“内部链接索引”后，访客能看到整个知识网络的结构图，点击即可跳转。

相当于每篇笔记都是节点，系统自动连成一张网，特别适合个人知识站对外展示。