Maia docs

Journal

Write articles in Markdown. Maia adds the journal page, post pages, related posts and an RSS feed.

Journal posts are Markdown files in src/content/posts/. The file name becomes the address: protein-at-breakfast.md is published at /journal/protein-at-breakfast/.

---
title: The breakfast change that ends 4 pm cravings
description: If you hit a wall every afternoon, the fix might start at breakfast.
date: 2026-09-30
category: Nutrition
---

Your article starts here.

## A heading

A paragraph with **bold**, *italic* and a [link](/recipes/).
Field Required What it does
title Yes The post title.
description Yes Shown under the title, on cards, in search results and share cards.
date Yes Publication date, YYYY-MM-DD. Newest posts come first.
updated No Shows “Updated” with this date.
category No A small label such as Mindset or Gut health. Defaults to Nutrition.
cover, coverAlt No A cover image, relative to the file, and its description. A photo cover is also used when the post is shared.
draft No true shows the post only in npm run dev.

What you can write

Everything in standard Markdown: headings, lists, links, images, quotes and tables, all styled for comfortable reading. Link to your recipes and programs to keep readers on your site.

To add an image, put it in src/assets/ and reference it relative to the post:

![A colourful breakfast bowl](../../assets/breakfast.jpg)

Where posts appear

  • The journal page at /journal/.
  • The newest three on the home page.
  • “Keep reading” suggestions at the end of each post.
  • The RSS feed at /rss.xml, for readers and email newsletter tools that can send new posts automatically.