Search and Outline

The theme includes a built-in search modal that works entirely client-side — no external service required.

Open search with any of these shortcuts:

  • / (when not focused on an input)
  • Ctrl+K (Windows/Linux)
  • Cmd+K (macOS)

The search index is generated from a search.json file at build time. It includes the home page and all documents from your sidebar collections. Results show matching page titles and content excerpts, and clicking a result navigates directly to that page.

TIP

If search doesn’t seem to find certain pages, make sure those pages belong to a collection listed in your _data/sidebar.yml. Only sidebar collections are indexed.

Right-side outline

The “On this page” outline appears on the right side of docs pages and lists all h2 and h3 headings on the current page.

As you scroll, the outline highlights the heading that’s currently at the top of the viewport. Clicking an outline link scrolls to that heading, offset so it’s visible below the fixed navbar. The offset distance is configurable:

jekyll_vitepress:
  behavior:
    scroll_offset: 134

The outline label defaults to “On this page” and can be changed via jekyll_vitepress.labels.outline.

On narrow screens, the outline collapses to keep the content area readable.