Tags Metadata
Organize pages with tags and enrich generated search index data

Tags are page metadata defined in frontmatter.

Adding Tags#

---
title: My Page
tags:
  - getting-started
  - tutorial
  - beginner
---

Where Tags Are Used#

  • Displayed in page metadata/footer chips by the default layout.
  • Included in generated search-index entries (SearchIndexGenerator).
  • Available to custom components/layout logic.

Current Default Layout Behavior#

The default KBLayout does not auto-render KBRelatedPages. If you want related-page cards, use KBRelatedPages explicitly in a custom layout composition.

Best Practices#

  1. Use consistent lowercase tag naming.
  2. Prefer specific tags (api-reference) over generic tags (api).
  3. Keep 3-6 tags per page.
  4. Keep tags as a YAML list for reliable parsing.