This directory contains all blog posts as Markdown files.

Each blog post should be a .md file with the following structure:

Frontmatter (YAML)

---
title: "Your Blog Post Title"
category: Category Name
categoryHref: /blog
date: November 12, 2025
author:
  name: Author Name
  title: Author Title
  imageUrl: https://example.com/author.jpg
  href: /authors/author-slug
  bio: Author bio text
featuredImageUrl: https://example.com/image.jpg
featuredImageAlt: Image description
aiTopic: "Optional AI topic for banner"
description: "Optional description for blog listing"
meta: "Optional meta text"
badge: "Optional badge text"
tableOfContents:
  - id: section-id
    title: Section Title
    level: 2
relatedArticles:
  - title: Related Article Title
    description: Article description
    imageUrl: https://example.com/image.jpg
    href: /blog/article-slug
    meta: Article
---

Content

Write your blog post content in Markdown below the frontmatter. Use standard Markdown syntax:

• Headings: ## Heading 2, ### Heading 3
• Add IDs to headings for table of contents: ## Section Title {#section-id}
• Paragraphs: Just write text
• Lists: - Item or 1. Item
• Links: [text](url)
• Images: ![alt](url)
• Blockquotes: > Quote text
• Code: `code` or ```code block```

Example

See 5-common-grc-incident-management-mistakes-and-how-to-fix-them-fast.md for a complete example.

File Naming

• Use kebab-case for file names: my-blog-post.md
• The filename (without .md) becomes the URL slug: /blog/my-blog-post