Docsify怎么添加目录列表

# Docsify怎么添加目录列表

在Docsify中自动生成目录列表是提升文档可读性的重要功能。以下是两种常用方法：

## 方法一：使用内置目录功能

在`index.html`中启用目录插件：
```html
<script>
  window.$docsify = {
    loadSidebar: true,  // 启用侧边栏
    subMaxLevel: 3      // 设置目录层级深度
  }
</script>

然后在项目根目录创建_sidebar.md文件：

- [首页](README.md)
- [安装指南](guide/installation.md)
- [API参考](api/README.md)

方法二：自动生成页面目录

在文档页面添加[toc]标记：

# 文档标题
[toc]

## 章节1
内容...

## 章节2
内容...

高级配置

1. 目录位置控制：

<div id="sidebar"></div>  <!-- 自定义容器 -->
<script>
  window.$docsify = {
    alias: {
      '/.*/_sidebar.md': '/_sidebar.md'  // 统一侧边栏
    }
  }
</script>

1. 样式调整：

/* docsify.css */
.sidebar {
  width: 300px !important;
}

注意事项： - 确保文件路径正确 - 层级深度建议不超过4级 - 更新后需清除浏览器缓存

通过以上配置，即可实现灵活的文档目录导航。 “`