Frontmatter

Baan articles use YAML frontmatter at the top of each Markdown file to store metadata. The built-in editor manages frontmatter through a form UI; external editor users write it directly.

Minimal Example

---
title: "Getting Started with Next.js"
date: "2025-01-15"
category: "Tech"
id: "getting-started-nextjs"
tags:
  - Next.js
  - React
---

Complete Field Reference

---
# ── Core fields ──────────────────────────────────────────
title: "Article Title"
date: "2025-01-15"          # Publication date (YYYY-MM-DD)
category: "Tech"             # Primary category (string)
id: "article-slug"           # URL slug — letters, numbers, hyphens, underscores only
tags:
  - Next.js
  - React

# ── Status ───────────────────────────────────────────────
status: "published"          # "published" | "draft" (default: "draft")

# ── Optional Metadata ────────────────────────────────────
description: "A concise summary for SEO meta description and OGP."
image: "images/hero.jpg"     # Cover image path, relative to the article folder
updatedAt: "2025-01-20"      # Last updated date (YYYY-MM-DD)

# ── AI-Generated Entities (Knowledge Graph) ──────────────
entities:
  - name: "Next.js"
    type: "Product"
    wikidataId: "Q110707225"
    description: "React-based web development framework"
    relevance: 1.0
    isMainSubject: true
  - name: "Vercel"
    type: "Organization"
    wikidataId: "Q110470520"
    description: "Cloud platform for frontend developers"
    relevance: 0.8
    isMainSubject: false
---

Field Details

title

The article’s display title. Used for the page <title>, OGP og:title, and the article heading.

date

The publication date in YYYY-MM-DD format. Used for sorting, RSS feeds, and Schema.org datePublished.

category

The primary category. Used for filtering and the category listing page. Can be a string or an array if you want the article to appear under multiple categories.

id

The URL slug for this article. In Baan-managed storage, the article folder name is the canonical ID; frontmatter id should match that folder when you write files by hand.

tags

An array of tags. Used for the tag listing pages and related-post suggestions.

status

Controls visibility on the public site:

• "published" — visible to all readers
• "draft" — saved but not publicly accessible

Default is "draft" if omitted. A post is publicly visible only when status: "published".

Caution

A post with status: "draft" is completely hidden from the public site, including RSS feeds and sitemaps. Always set status: "published" when you’re ready for readers to see it.

description

A short summary (1–2 sentences) used for:

• The <meta name="description"> tag
• og:description for social sharing
• Article cards on category/tag listing pages

If omitted, Baan may generate one from the first paragraph.

image

Path to the cover image, relative to the article folder. Example: images/hero.jpg points to {article-id}/images/hero.jpg in storage.

Used for og:image and the article card thumbnail.

updatedAt

Date the article was last significantly updated (YYYY-MM-DD). Used for Schema.org dateModified and shown to readers as “Updated on”.

entities (AI-generated)

Structured entities extracted by the Knowledge Graph feature. Written automatically when you run Extract Entities in the admin panel — you don’t need to write this by hand.

Each entity has:

• name — entity name
• type — Person | Place | Organization | Concept | Event | Product | CreativeWork
• wikidataId — Wikidata Q-number for disambiguation, when available
• description — short description from Wikidata, when available
• relevance — score from 0 to 1
• isMainSubject — true if this entity is the main topic of the article

Entities marked isMainSubject: true are output as about in JSON-LD; others as mentions.