Starting a blog nobody asked for
Most blogs die at post three. The first is enthusiasm, the second is momentum, and the third is when you realise you have to actually have something to say.
This is a sample post. Delete it, or keep it as a reference for the frontmatter and the formatting below.
What the frontmatter does
Every post needs a title, description, and date. Tags are optional, and
so is updated — set it when you revise a post and the date line will show
both. Set draft: true and the post disappears from the list, the feed, and
the sitemap, but stays visible while you run astro dev.
The schema is type-checked at build time. Misspell a key and the build fails rather than quietly shipping a page with a missing title.
Formatting
Standard Markdown works. Headings, bold, italic, links, and lists:
- Unordered items
- Nest them if you need to
- Keep them short
Code blocks are syntax-highlighted, and the theme was chosen so comment tokens clear WCAG AA contrast — many popular highlighting themes do not:
export function readingTime(body) {
const words = body.trim().split(/\s+/).length;
return Math.max(1, Math.round(words / 200));
}
Blockquotes work too. Useful for the thing someone else said better than you could.
What happens next
Add another Markdown file to src/content/posts/. That is the whole workflow.