Blog Posts

This directory contains all blog posts in Markdown format.

Creating a New Blog Post

  1. Create a new .md file in this directory (e.g., my-new-post.md)
  2. Add frontmatter at the top of the file:
---
title: Your Post Title
publishedAt: 2024-01-15T00:00:00.000Z
excerpt: A brief description of your post
author:
  name: Author Name
  image: /path/to/author-image.jpg  # Optional
mainImage:
  url: /path/to/main-image.jpg
  alt: Image description
categories:
  - title: Category Name
    slug: category-slug
isFeatured: false  # Set to true to feature on homepage
---
  1. Write your content below the frontmatter using Markdown

Frontmatter Fields

  • title (required): The post title
  • publishedAt (required): ISO 8601 date string
  • excerpt (required): Brief description for listings
  • author (optional): Author information
    • name: Author's name
    • image: Path to author image (relative to /public)
  • mainImage (optional): Main featured image
    • url: Path to image (relative to /public)
    • alt: Alt text for the image
  • categories (optional): Array of category objects
    • title: Category display name
    • slug: URL-friendly category identifier
  • isFeatured (optional): Boolean to feature on homepage

Markdown Support

The blog supports standard Markdown plus GitHub Flavored Markdown (GFM) features:

  • Headings, paragraphs, lists
  • Links, images
  • Code blocks (with syntax highlighting)
  • Blockquotes
  • Tables (GFM)
  • Strikethrough (GFM)

Example Post

See example-post.md for a complete example.