YAML frontmatter tells software what a file is about before the normal writing begins. It’s metadata, meaning information about the content, and it helps tools sort, filter, validate, display, and connect the file.
Think about a cover sheet clipped to the front of a client folder. The folder may contain notes, emails, reports, and drafts, but the cover sheet carries the client name, owner, status, and due date. You understand the folder faster because the key facts are pulled to the front. Frontmatter is that cover sheet for a markdown file.
How it shows up
In this glossary, frontmatter tells the site the slug, title, aliases, category, related terms, motif, and correction status for each entry. The body explains the term; the frontmatter lets the site turn the entry into a card, a page, a search result, and a related-term block. YAML uses labels and values a person can read and a program can parse. It’s close to JSON, but friendlier for humans editing files directly, where JSON is stricter and better for systems talking to systems. The schema matters because metadata only helps if it’s consistent: if one file says category, another says type, and another says topic, the software has to guess.
Why you care
Frontmatter is one of those small boring things that makes a knowledge system work. Without it, every file is just prose; with it, the same file can be read by a person and organized by software. For AI work, agents can search, route, validate, and update files more reliably when the cover sheet is clear.