creating blog posts

This guide explains how to create blog posts for the site.

Quick Start

1. Create a new .md file in src/content/blog/
2. Add the required frontmatter
3. Write your post
4. Build and preview

Required Frontmatter

Blog posts need this frontmatter:

---
title: 'Your Post Title'
description: 'Brief description for SEO and previews'
publishDate: 2025-08-01
category: 'Technology' # or AI, Research, etc.
tags: ['web-dev', 'astro']
heroImage: '/blog/your-image.jpg' # optional
draft: false # set true to hide from listings
---

File Naming Convention

Use the date prefix format:

YYYY-MM-DD-post-slug.md

Example: 2025-01-31-my-first-post.md

Categories

Common blog categories:

• Technology - Tech tutorials and insights
• AI - AI and machine learning topics
• Research - Research findings and papers
• Personal - Personal thoughts and updates

Adding Images

Place images in public/blog/ and reference them:

![Alt text](/blog/image-name.jpg)

Or use the hero image in frontmatter for the post header.

Draft Posts

Set draft: true to work on posts without publishing:

---
title: 'Work in Progress'
draft: true
---

Writing Tips

• Start with a compelling introduction
• Use headers to structure content
• Include code examples where relevant
• Add relevant tags for discoverability
• Keep paragraphs short and scannable

Publishing Workflow

1. Write your post with draft: true
2. Preview locally with npm run dev
3. When ready, set draft: false
4. Commit and push your changes