Mike Boiko

Personal projects, Linux-heavy workflows, self-hosting, and technical notes.

Back to the blog
  • markdown
  • writing
  • astro

A Markdown post template for future articles

Use this sample entry as the starting point for future posts on your personal blog.

1 min read Updated

This post is intentionally written as a starter template. Duplicate it, rename the file, update the frontmatter, and you have a clean structure for future writing.

Suggested structure

A strong technical post usually starts with three things:

  1. The problem you were solving
  2. The constraints you had to work with
  3. The result you shipped or learned from

That gives readers enough context to understand why the rest of the article matters.

Example code block

export function buildSlug(title: string) {
  return title
    .toLowerCase()
    .trim()
    .replace(/[^a-z0-9]+/g, '-')
    .replace(/(^-|-$)/g, '');
}

Example checklist

  • Start with a clear title and summary
  • Add tags that help group related writing
  • Include code only when it supports the point
  • End with the trade-offs or lessons learned

Example table

SectionWhat to include
IntroProblem, context, desired outcome
BuildDecisions, architecture, implementation notes
ReflectionWhat worked, what changed, what you would do next

Frontmatter reference

The current blog schema supports these fields:

  • title
  • description
  • publishDate
  • updatedDate
  • featured
  • draft
  • tags

Writing note

Because this site uses plain Markdown by default, the authoring workflow stays simple: open a file, write the article, commit it, and publish. If you ever need embedded interactive components, you can add MDX later without rebuilding the whole content model.