tommt.com

Article

Content Workflow

A practical authoring guide for adding new posts by dropping one folder into the content directory.

Published Updated
Content Workflow

This article is itself a reference template for future content.

Base directory

All articles live in:

src/content/blog/

Each article should have its own folder:

src/content/blog/your-post-slug/
  index.md
  cover.jpg
  image-1.jpg

Frontmatter rules

These are the fields currently expected by the site:

---
title: "Article title"
description: "Short summary shown in archive cards and SEO descriptions"
pubDate: "2026-06-22"
heroImage: "./cover.jpg"
updatedDate: "2026-06-23"
draft: false
---

Field notes

  • title: required
  • description: required
  • pubDate: required, preferably in YYYY-MM-DD format
  • heroImage: optional, but recommended
  • updatedDate: optional
  • draft: optional; when set to true, the article stays off the public site

If you are publishing a standard article:

index.md

If you need Astro components inside the body:

index.mdx

Image usage

Set the cover image in frontmatter:

heroImage: "./cover.jpg"

Reference body images directly in Markdown:

![Example image](./image-1.jpg)

With that structure in place, dropping in one folder is enough to update the archive, article page, and RSS feed automatically.