Vitepress-plugin-auto-sidebar NPM

:zap: VitePress Plugin: Auto Sidebar

Generate the VitePress sidebar through the folder structure.

✨ Release Notes

Features

Small library
TypeScript Support

Setup

yarn add vitepress-plugin-auto-sidebar # yarn
npm i vitepress-plugin-auto-sidebar # npm

Basic usage

.vitepress/config.js

import { getSidebar } from 'vitepress-plugin-auto-sidebar'

export default {
  themeConfig: {
    sidebar: getSidebar({ contentRoot: '/', contentDirs: ['team'], collapsible: true, collapsed: true })
  }
}

Options

contentRoot – Default: '/'
String Root of your VitePress Docs
contentDirs – Default: '/'
Array of indexable contentRoot dirs, if you want to include separately. Accepts string[] or { path: string, title?: string }[]
collapsible – Default: true
Boolean whether the first level can be unfolded
collapsed – Default: true
Boolean whether the first level items are already expanded after loading
useFrontmatter - Default: false
Boolean whether use front-matter for title of items

Tips: If you want to ignore a file, name the .md file with an underscore (_).