Maia docs

Recipes

Publish recipes with ingredients, steps and nutrition, ready for Google's recipe results.

Each recipe is a Markdown file in src/content/recipes/. The file name becomes its address: berry-overnight-oats.md is published at /recipes/berry-overnight-oats/.

---
title: Berry & banana overnight oats
description: Five minutes the night before, and breakfast is ready.
date: 2026-09-18
cover: ../../assets/art/recipe-oats.svg
coverAlt: A bowl of overnight oats topped with berries
category: Breakfast
diet: [Vegetarian, Gut-friendly]
prepTime: 5
cookTime: 0
servings: 1
calories: 380
nutrition: { protein: 16 g, carbs: 54 g, fat: 10 g, fibre: 9 g }
featured: true
ingredients:
  - 50 g rolled oats
  - 1 tbsp chia seeds
steps:
  - Stir the oats, chia seeds and milk together.
  - Leave in the fridge overnight.
---

A short introduction, tips or swaps, in normal Markdown.
Field Required What it does
title, description Yes Name and a one- or two-sentence description.
date Yes Publication date, YYYY-MM-DD. Newest recipes come first.
cover, coverAlt Yes / No The recipe image, relative to the file, and its description.
category Yes For example Breakfast. Each category gets its own page and filter button.
diet No Labels such as Vegetarian, Gluten-free or High protein.
prepTime, cookTime Yes / No Minutes. The total is worked out for you.
servings Yes Number of servings.
calories No Calories per serving.
nutrition No protein, carbs, fat and optionally fibre, per serving, as text such as 16 g.
ingredients Yes One line per ingredient. Visitors can tick them off while cooking.
steps Yes One entry per step. They’re numbered automatically.
featured No true puts the recipe on the home page first.
draft No true hides the recipe, except in npm run dev.

The text after the frontmatter appears between the recipe heading and the recipe card: use it for the story, tips and swaps.

Categories

Category pages are created automatically from the category of your recipes, for example /recipes/category/breakfast/. To add a category, just use a new name in a recipe.

Google recipe results

Every recipe page includes Recipe structured data: ingredients, steps, times, servings and nutrition. This lets Google show your recipes with an image, rating and cook time in search. Google needs a photo for this, so use a JPG, PNG or WebP cover rather than an illustration once you have your own photography. You can test a page with Google’s Rich Results Test.

Printing

The Print recipe button prints a clean version of the recipe, without the menu, footer and extra sections.