BetterStarter logoBetterStarter
GuidesBlog

Write a Blog Post

Publish a new blog post in minutes.

Docs are in beta — content is improving rapidly. Found something missing? Open an issue on GitHub or reach out on Twitter.

Blog posts live in content/blog/ as .mdx files. The file name becomes the URL slug.

Create a Post

  1. Create a file in content/blog/:
content/blog/my-first-post.mdx
  1. Add frontmatter and content:
---
title: "My First Post"
description: "A brief description for previews and SEO (keep under 160 chars)"
published: "2026-04-17"
tags: ["saas", "tutorial"]
---

## Introduction

Your content starts here.

Required Frontmatter

FieldRequiredDescription
titleYesPost title
descriptionYesShort summary (≤160 chars)
publishedYesDate in YYYY-MM-DD format
tagsNoArray of tags
imageNoPath to cover image
draftNoSet true to hide from listing

Images

Place images in public/blog-assets/ and reference them with an absolute URL:

![My image](/blog-assets/my-post/screenshot.jpg)

Publishing

Commit the file. The post immediately appears on /blog/, in the RSS feed, and in the sitemap. No build step required for content changes.

Preview Locally

pnpm dev

Navigate to http://localhost:3000/blog/my-first-post.

On this page