How to Write Blog Posts in Markdown

Writing Blog Posts in Markdown

This blog uses a simple, file-based content management system powered by Markdown files. Here's how it works.

The Basics

Each blog post is a Markdown file (.md) stored in the content/blog/ directory. The filename becomes the URL slug.

For example:

• content/blog/my-post.md → /blog/my-post
• content/blog/ai-tips.md → /blog/ai-tips

Frontmatter

At the top of each Markdown file, you'll add frontmatter - metadata about the post:

---
title: "Your Post Title"
date: "2025-01-19"
excerpt: "A short description of your post"
author: "Your Name"
image: "/images/your-image.png"
---

Writing Content

After the frontmatter, write your content using standard Markdown:

## Headings

Use ## for main headings and ### for subheadings.

### Lists

- Bullet point one
- Bullet point two
- Bullet point three

### Emphasis

Use *italics* for emphasis and **bold** for strong emphasis.

### Links

[Link text](https://example.com)

### Code

Inline `code` or code blocks:

```javascript
function hello() {
  console.log("Hello, world!");
}

### Publishing a Post

1. Create a new `.md` file in `content/blog/`
2. Add frontmatter with title, date, excerpt, author, and image
3. Write your content in Markdown
4. Save the file
5. Rebuild the site with `npm run build`
6. Deploy your changes

The blog automatically generates the listing page and individual post pages.

### Why Markdown?

**Simple** - No complex CMS to learn or maintain

**Fast** - Static files mean lightning-fast page loads

**Version Controlled** - All posts tracked in Git

**Portable** - Your content isn't locked in a database

**Developer Friendly** - Write in any text editor

### Tips for Great Posts

- **Start with the why** - Why should readers care about this topic?
- **Use examples** - Real examples are more valuable than theory
- **Break it down** - Use headings to organize your thoughts
- **Keep it conversational** - Write like you're talking to a colleague
- **Add value** - Share something readers can actually use

### Next Steps

Ready to write your first post? Just create a new Markdown file in `content/blog/` and follow the format above.

Questions? [Contact us](/contact) or check out the other posts for examples.