{% article %}

Attributes

Parameter	Type	Required	Description
date	string	✓	ISO 8601 date — creation or publication date (e.g. 2026-05-05)

Valid Children

Tag	Multiplicity
{% tldr %}	[?]
{% quote %}	[*]
{% asset %}	[*]
{% callout %}	[*]
{% footnote %}	[*]
{% atom %}	[*]
{% carousel %}	[*]
{% citation %}	[*]
{% cite %}	[*]
{% bibliography %}	[?]

Rules

Rule	Force	Realm	Reference	Description
article-scope-public-only	must	global	—	Articles are always . The attribute is not supported on or any of its children. The agent pass skips all article documents — no TOON bundle is written. scope
article-no-include	must	global	—	Articles do not support . Fragment inlining could inject footnotes from other sources, breaking the sequential numbering contract. Articles are self-contained documents. authoring
article-date-iso8601	must	global	—	The attribute must be ISO 8601 (e.g. ). It is displayed as a badge on the article page and used for sidebar ordering (newest first). convention

Articles are the only document type with no parent tag. They live in content/articles/ and are never exposed via MCP or included in agent bundles.

Frontmatter

Field	Required	Notes
type	yes	Always "article"
id	yes	kebab-case — used as the URL slug and asset directory name
title	yes	Display title shown in the sidebar and page heading
status	yes	draft or published
date	yes	ISO 8601 date (e.g. 2026-05-05)
tags	no	Space-separated labels — collected in the Article Tag Index at /articles/tags
domain	no	Optional sidebar grouping under a domain label

Child tags

Tag	Description
\{% quote %\}	Block quotation with optional attribution. See \{% quote %\}.
\{% asset %\}	Embedded or linked media (image, video, audio). See \{% asset %\}.
\{% callout %\}	Styled callout box. See \{% callout %\}.
\{% footnote %\}	Inline footnote collected at the page bottom. See \{% footnote %\}.
\{% atom %\}	Typed knowledge unit. See \{% atom %\}.
\{% carousel %\}	Slideshow container. See \{% carousel %\}.
\{% citation %\}	Bibliographic reference declaration. See \{% citation %\}.
\{% cite %\}	Inline citation marker. See \{% cite %\}.
\{% bibliography %\}	Local bibliography renderer. See \{% bibliography %\}.

Page layout

Content renders in document order. \{% footnote %\} is the only exception — markers are placed inline but content is emitted at the bottom of the page below an <hr />.

─────────────────────────────────
Title                  date badge
─────────────────────────────────

[prose, quotes, callouts, atoms,
 assets, carousels — in source order]

─────────────────────────────────
Footnotes
1. ...
2. ...
─────────────────────────────────

Sidebar placement

Articles appear in the Journal section, grouped under Articles, sorted by date descending (newest first).

Minimal article with tldr and prose

tagarticle article-tag-minimal

{% article date="2026-05-05" %}

{% tldr %}
One-sentence summary shown as the page meta description.
{% /tldr %}

## Introduction

Prose, quotes, callouts, atoms, and assets flow freely here — like a blog post.

{% /article %}

Tag Tree

{% tldr %}[?]One-sentence summary rendered as a lead paragraph and used as the document's short description throughout the site.{% quote %}[*]A block quotation with optional attribution. Collected globally into the Quotes aggregate page at .{% asset %}[*]Self-closing tag that embeds or links a media asset — image, video, audio, or HTML page. Supports inline display () and clickable link mode (). HTML assets open in a modal dialog with an iframe.{% callout %}[*]A styled callout box for emphasis, tips, warnings, or asides. The attribute drives the left-border accent and background tint. Supports an optional icon.{% footnote %}[*]Inline footnote marker. The body content is collected and rendered as a numbered list at the bottom of the article page. The inline position is replaced by a superscript link.{% atom %}[*]Marks a prose block as a typed knowledge unit — definition, hypothesis, axiom, prediction, observation, learning, question, or idea. Rendered inline with a type badge; collected globally into per-type aggregate pages under the Knowledge Base sidebar group.{% carousel %}[*]A slideshow container that cycles through children. Supports autoplay, configurable interval, and looping.{% slide %}[*]A single slide within a . Each slide has an optional label shown as a tab or navigation indicator, and a body of arbitrary article content.{% citation %}[*]Defines a bibliographic reference entry within an article. Self-closing. Collected globally into the Bibliography aggregate page at . Referenced inline with .{% cite %}[*]Inline citation reference marker. Self-closing. References a entry defined in the same article by its key. Rendered as a superscript bracketed link in the prose.{% bibliography %}[?]Self-closing placeholder tag that renders a local bibliography of all entries defined in the current article.