Extending Behavior

Because this is Jekyll, extension points are straightforward:

  • override _layouts/default.html
  • override specific includes (e.g. nav.html, doc_footer.html)
  • use slot includes for additive markup:
    • _includes/vp_slots/doc_footer.html
    • _includes/vp_slots/layout_bottom.html
  • add your own JS/CSS assets

For behavior customizations, you can fork/extend assets/js/vitepress-theme.js while keeping the HTML structure intact.

WARNING

Keep class names and DOM structure stable if you rely on built-in JS for sidebar, outline, and search interactions.