Skip to content
Early bird + Black Friday · 73% off

Get ZeroDirs for $179 $49

Claim $49 deal

Blog and feeds

src/content/blog/ holds Markdown posts. features.blog, on by default, builds /blog/, one page per post and /blog/rss.xml.

src/content/blog/my-first-post.md
---
title: Why we started this directory
description: The gap we kept running into.
pubDate: 2026-09-14
tags: [editorial]
draft: false
---
The body is Markdown.

The file name is the URL: my-first-post.md becomes /blog/my-first-post/. Keep posts at the folder’s top level.

Field What it does
title required; the heading and <title> (seo.templates.blog.title, then titleTemplate)
description required; the sub-heading line, the meta description, the feed item text
pubDate required; the date shown, newest first
updatedDate Updated when the day differs; article:modified_time, which the sitemap reads as lastmod
cover a path or URL, rendered at 1200×630 as the og:image; not validated
tags default []; chips, no pages behind them
draft default false; hides the post

Replace the demo posts:

Terminal
pnpm content:reset --yes

It deletes the demo listings from the local database (--remote for the real one) and their logos from the bucket, then every .md in src/content/blog/ except unpublished-draft.md, writes hello-world.md, logs blog: kept src/content/blog/unpublished-draft.md (starter fixture, draft: true — delete it if you do not want it). The reverse is pnpm content:use <dataset> --yes.

Where You should see
Index /blog/ your posts newest first and the RSS feed button
Post /blog/<file name>/ the title, description, date, tags and body
Blog feed /blog/rss.xml <title><site name> Blog</title>, one <item> per published post, every link starting with site.url
Listings feed /rss.xml <title><site name></title> and at most 50 items
Sitemap chunk /sitemap-blog-0.xml one <url> per post plus /blog/, <priority>0.5</priority>; the build log reads sitemap: N urls in M chunks (listings=…, blog=…)

The demo’s /blog/ index

One demo post

  • Feed item links are absolute against site.url: both feeds point at the wrong domain until it is yours.
  • /rss.xml is always built — the newest 50 listings by approvedAt; /blog/rss.xml follows features.blog and has no limit.
  • The demo posts name real products — Grammarly, LanguageTool, DeepL Write — and are not licensed as your own editorial; replace them before going live.
  • Posts are not in the site search, /blog/ has no pagination or tag pages, and an empty folder shows No posts yet — check back soon.
  • /robots.txt points at /sitemap-index.xml, which lists sitemap-blog-0.xml; the feeds are files, not pages, and appear in neither. See Sitemap and robots.
Config state The visitor sees /admin/ reports Fix
features.blog: false no Blog nav item; /blog/, the post pages and /blog/rss.xml are not built and 404 once deployed; /rss.xml is unaffected nothing set it back to true
A post with draft: true not built, not on /blog/, not in the feed; Draft badge under pnpm dev nothing draft: false, or delete the line
A post missing title, description or pubDate no site: the build stops, **blog → <file>** data does not match collection schema., naming the field nothing add the field
A post in a subfolder no site: the build stops, paths: invalid path segment "<id>" nothing move the file to the top level

features.blog, seo.templates.blog.title, seo.templates.blog.description (unused today — the index and every post pass their own), site.locale and site.url — features, seo, site.

  • Directorysrc/content/blog/ — the posts; unpublished-draft.md is the draft fixture
    • …
  • src/content/schema.ts — blogSchema, the frontmatter rules above
  • Directorysrc/pages/blog/ — /blog/, /blog/<slug>/ and /blog/rss.xml
    • …
  • src/pages/rss.xml.ts — the listings feed and its item limit
  • src/templates/BlogIndexPage.astro — the index
  • src/templates/BlogPostPage.astro — one post
  • Directorysrc/components/blog/ — the post card, the meta line and getPublishedPosts()
    • …
  • integrations/sitemap.ts — the chunked sitemap and its build log line