How to Write a Blog Post in Markdown
A complete guide on using Markdown for the BNK Services blog, including frontmatter schemas, code blocks, and formatting.
Documentation Team
Engineering Team
Writing for the BNK Services Blog
Welcome to the BNK Services content guide. Writing a new post is incredibly simple thanks to Astro’s Content Collections. Because we utilize strict Zod schemas, your content is guaranteed to be perfectly formatted and SEO-optimized every single time.
1. Creating a New Post
To create a new post, simply create a new .md file inside the src/content/blog/ directory. The name of the file will automatically become the URL slug.
2. Frontmatter Configuration
Every file must begin with a strict YAML frontmatter block that matches our schema constraints. If you miss a required field or your description is over 160 characters, the Astro compiler will intentionally fail the build to protect our SEO rating!
---
title: "Your Post Title"
description: "A short 160 character description for SEO."
pubDate: 2026-10-31
author: "Your Name"
category: "Technology"
tags: ["Tech", "News"]
draft: false
---3. Formatting Content
You can use standard Markdown to format your text. The Tailwind Typography (prose) plugin will automatically style it to match our enterprise theme.
- Bold text for strong emphasis.
- Italic text for subtle highlights.
- Links to external resources.
Code Blocks
For technical articles, you can include syntax-highlighted code blocks by using triple backticks:
function greet() {
console.log("Hello from BNK Services!");
}Adding Images
Images will automatically center and format themselves perfectly:
Happy writing!