Page Front Matter#

Add optional YAML front matter at the beginning of a chapter to control its page metadata and URL. The title in SUMMARY.md remains the sidebar label.

---
title: Install the CLI
description: Install docia on macOS, Linux, or Windows.
slug: /installation
ogImage: /social/installation.png
noindex: false
redirectFrom:
    - /install
    - /getting-started/install
---

Fields#

  • title: browser, search, Open Graph, and page metadata title
  • description: page-specific search and social description
  • slug: stable URL path independent of the Markdown filename
  • ogImage: page-specific social preview image
  • draft: omit the page and its nested navigation from production builds
  • noindex: keep the page available but omit it from sitemaps and llms.txt
  • redirectFrom: old paths that should redirect to the page

Draft pages are included by docia dev for previewing and marked noindex. A production docia build omits them. docia check reports links from published pages to drafts.

Redirect paths and slugs must be URL paths without a protocol, query string, hash, or .html extension. Output formatting still follows prettyUrls.