Articles are Markdown files in src/content/articles. The filename is the URL:
this one lives at writing-here.md and appears at /articles/writing-here.
There is no admin panel and no database — git is the whole content system, so
writing is the same as any other change to the site.
What a file needs
Every article opens with a frontmatter block between --- lines. Only title
and date are required. description is used for search results and link
previews, and standfirst is the line under the title.
---
title: The Tower is not about your house
description: What the card actually asks of you.
date: 2026-09-01
standfirst: An optional line under the title.
---
Below that, write Markdown. Headings, bold, italic, lists, quotes, tables and links all work, and none of them need classes — how they look is decided in one place, so an article is only ever words.
Linking to the rest of the site
An internal link like the Celtic Cross becomes a proper client-side link automatically. Card meanings, decks, spreads and example chart readings are all fair game, and linking to them is most of what makes an article worth writing here rather than anywhere else.
Drafts
An article dated in the future stays off the index until that day. That is the only draft mechanism, and it is usually enough: write it, date it, push it, and it appears on its own.
Publishing
Commit the file and push. The article is built into the site — no rebuild button, no cache to clear — and it is added to the sitemap, so search engines find it without being told twice.