Frontmatter Conventions: Schema Validation, Canonical Metadata, and Knowledge Graph Indexing

Every article and hub on Wikantik includes structured YAML frontmatter at the top of the file. This metadata is parsed by the backend knowledge engine to power hybrid search filtering, generate SERP meta-description snippets, maintain breadcrumb taxonomies, and project semantic RDF triples into the Apache Jena Knowledge Graph.

This guide details the mandatory and optional frontmatter fields, length validation constraints, and Knowledge Graph ingestion rules.

---

1. Quick-Reference: Mandatory Frontmatter Schema

---
title: "Clear, High-Intent Article Title (Max 90 chars)"
cluster: "canonical-kebab-case-cluster-name"
type: "article" # or "hub", "reference", "tutorial"
status: "active" # or "draft", "deprecated"
audience:
  - "humans"
kg_include: true
summary: "Compelling, search-optimized meta description between 120 and 158 characters long."
tags:
  - "primary-tag"
  - "secondary-tag"
---

---

2. Strict Validation Gotchas

1. Summary Length: The summary must be between 50 and 160 characters. Summaries exceeding 160 characters trigger validation warnings.
2. Escaped Dollar Signs: If currency appears in the summary or title, escape it (\$50K) to prevent KaTeX math rendering crashes.