An Editorial System That Outlives Its CMS

Content is the permanent layer

Interfaces change. CMS products change. The durable object is a versioned document whose meaning remains intact when its source moves from local files to Matrix.

That requires three simple rules:

• prose remains portable CommonMark;
• complex presentation becomes a typed block;
• raw executable markup never enters the document.

The same object can serve a web page, an RSS feed, structured metadata or an LLM-readable index. Inline concepts such as ArticleDocument remain readable without controlling the design.

A small contract with a long life

The renderer understands a discriminated set of blocks. Matrix will later deliver this same contract through an API; it will not dictate the interface.

type ArticleDocument = {
  version: 1
  blocks: ArticleBlock[]
}

type ArticleBlock =
  | { id: string; type: 'richText'; markdown: string }
  | { id: string; type: 'figure'; image: MediaAsset }
  | { id: string; type: 'code'; language: string; code: string }

The editor still feels simple

The underlying model should never punish the writer. Ordinary composition remains familiar:

1. write the thought;
2. choose a meaningful block only when needed;
3. preview the actual reading experience.

• headings, emphasis and links
• ordered and unordered lists
• tables, code and quotations
• future editorial workflow in Matrix

Portability is not a technical afterthought. It is part of authorship.

Built once, allowed to evolve

This is not an imitation of a generic publishing platform. It is a compact editorial language for one body of work—consistent enough to scale, flexible enough to remain personal.