Skip to main content
Back to home

Your Blog Post Title Here

By Merlin HardistyJanuary 25, 20263 min read

Introduction

Start with a compelling introduction that hooks the reader and explains what they'll learn from this post. Keep it concise but engaging.

Main Section 1

Your first main point or topic. Use clear headings to organize your content.

Subsection (Optional)

You can use subsections (h3) to break down complex topics further.

Key Points

  • Use bullet points for lists
  • Keep items concise and scannable
  • Each point should be valuable

Code Examples

When sharing code, use fenced code blocks with language specification:

// TypeScript example
interface User {
  id: string;
  name: string;
  email: string;
}

function greetUser(user: User): string {
  return `Hello, ${user.name}!`;
}
# Bash commands
npm install package-name
npm run dev
// Golang example
package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}

Ordered Lists

When order matters, use numbered lists:

  1. First step
  2. Second step
  3. Third step

Inline Code and Emphasis

Use inline code for commands, function names, or variables. Use bold for emphasis and italics for subtle emphasis.

Blockquotes

Use blockquotes for important callouts, quotes, or to highlight key takeaways.

They can span multiple lines.

Include relevant links to external resources or internal pages.

Images (Optional)

If you add images, place them in a public/images/blog/ directory:

Alt text describing the image

Best Practices

Share practical tips and best practices:

  • Performance: Optimize for speed
  • Security: Follow security best practices
  • Maintainability: Write clean, readable code
  • Testing: Always include tests

Common Pitfalls

Highlight mistakes to avoid:

  1. Don't do this common mistake
  2. Avoid this anti-pattern
  3. Remember this important consideration

Conclusion

Summarize the key takeaways from your post. Optionally, include a call-to-action or next steps for readers.


Template Usage Notes

Delete this section before publishing!

Frontmatter Fields:

  • title: The post title (keep it concise and descriptive)
  • date: Publication date in YYYY-MM-DD format
  • excerpt: 1-2 sentences for previews (aim for 120-160 characters)
  • tags: Array of relevant tags (use lowercase, hyphenated tags)

Common Tags:

  • Backend: golang, node, python, rust, api-design, microservices
  • Infrastructure: kubernetes, terraform, aws, docker, devops
  • Databases: postgresql, redis, mongodb, sql
  • General: architecture, performance, security, testing, best-practices
  • Web: nextjs, typescript, react, web-development

Writing Tips:

  1. Use clear, descriptive headings (h2 for main sections, h3 for subsections)
  2. Keep paragraphs short (3-4 sentences max)
  3. Use code examples to illustrate points
  4. Include practical, actionable advice
  5. Proofread for typos and clarity
  6. Aim for 800-2000 words for substantial posts

File Naming:

  • Use kebab-case: my-blog-post-title.md
  • Keep filenames descriptive but concise
  • The filename becomes the URL slug