Qrcode.
Back to all articles
3 min read

Blog Writing Guide

How to Write a Blog Post

  1. Create a new Markdown file in the content/blog/ directory
  2. Name it using kebab-case (e.g., my-awesome-blog-post.md)
  3. Use the template below as a starting point
  4. Set published: true when ready to publish, or false to save as draft

Template

---
title: "Your Blog Post Title"
description: "A compelling 150-160 character description for SEO and social sharing"
date: "2025-11-23"
updatedDate: "2025-11-23"  # Optional: only if you update the post later
author: "team"  # Or your name
tags: ["Tag1", "Tag2", "Tag3"]  # 3-5 relevant tags
published: true  # Set to false to save as draft
image: "/images/blog/your-image.jpg"  # Optional: featured image URL
---

# Your Blog Post Title

<div class="direct-answer">
<strong>Direct Answer:</strong> Start with a clear, direct answer to the main question your post addresses. This helps with SEO and user experience.

[Learn more about this topic →](/relevant-link)
</div>

---

## Table of Contents

- [First Section](#first-section)
- [Second Section](#second-section)
- [Conclusion](#conclusion)
- [Frequently Asked Questions](#frequently-asked-questions)

---

## First Section

Write your content here using Markdown. You can use:

- **Bold text**
- *Italic text*
- [Links](https://example.com)
- Lists
- Code blocks

### Subsection

You can nest headings for better organization.

---

## Second Section

More content here...

---

## Conclusion

Wrap up your post with key takeaways.

---

## Frequently Asked Questions

### Question 1?

**Answer:** Your answer here.

### Question 2?

**Answer:** Your answer here.

---

**Ready to learn more?** [Call to action →](/link)

Required Frontmatter Fields

  • title: The blog post title (appears in H1 and SEO)
  • description: Meta description for SEO (150-160 characters)
  • date: Publication date (YYYY-MM-DD format)
  • author: Author name (defaults to "team")
  • tags: Array of tags for categorization
  • published: true to publish, false for draft

Optional Frontmatter Fields

  • updatedDate: When you last updated the post
  • image: Featured image URL (appears at top of post)
  • schema: FAQ structured data (for advanced SEO)

Tips

  1. Use descriptive headings - They become anchor links automatically
  2. Include a Table of Contents - Helps with navigation
  3. Add a "Direct Answer" box - Great for SEO and UX
  4. Use tags wisely - Helps readers find related content
  5. Include FAQs - Common questions improve SEO
  6. Add internal links - Link to other pages on your site
  7. Use images - Visual content improves engagement

Example Tags

  • "QR Codes", "Dynamic QR", "QR Analytics"
  • "Marketing", "Branding", "Print Media"
  • "Analytics", "Tracking", "Engagement"
  • "How-To", "Tutorial", "Best Practices"

Publishing Checklist

  • [ ] Frontmatter is complete and correct
  • [ ] published: true is set
  • [ ] Content is proofread
  • [ ] Links are working
  • [ ] Images are optimized
  • [ ] Tags are relevant
  • [ ] Table of contents is accurate