How to Write Articles on This Blog

This blog uses MDX — write in Markdown and drop in React components when you want rich media. Here's everything you can do.

1. Create a new post

Add a file to content/posts/your-slug.mdx. The file must start with frontmatter:

---
slug: your-slug
title: Your Article Title
excerpt: One-line summary that shows on the home page and social previews.
date: 2026-05-24
author: msaad
tags: [AI, ChemE]
cover: https://example.com/banner.jpg
---

The slug becomes the URL: blog.saadengineer.works/your-slug.

2. Headings and text

Use Markdown for everything basic.

Subheading

Regular paragraphs just work. Bold, italic, links, and inline code are all supported.

Pull quotes look great with the > blockquote syntax. Use them to highlight key takeaways.

• Bullet lists work
• Across multiple lines
• With nested formatting

1. Numbered lists too
2. Just like that

3. Code blocks

Triple-backticks with a language give you syntax highlighting:

def fine_tune(model, dataset):
    for epoch in range(epochs):
        loss = model.train(dataset)
        print(f"Epoch {epoch}: loss={loss:.4f}")
    return model

const greet = (name) => `Hello, ${name}!`;
console.log(greet("Engineer Saad"));

4. Embed images

Use the <Figure /> component for nice captions:

5. Embed YouTube videos

Use the <YouTube /> component with the video ID:

6. Publish

1. Save the file
2. Commit and push to GitHub
3. Vercel auto-deploys in ~30 seconds
4. Your article is live at blog.saadengineer.works/your-slug

7. Authors

Add yourself in content/authors/your-id.json:

{
  "id": "your-id",
  "name": "Your Name",
  "bio": "Short bio.",
  "avatar": "https://example.com/avatar.jpg",
  "social": { "x": "https://x.com/...", "website": "https://..." }
}

Then reference your author: your-id in any post's frontmatter. Multiple authors can publish here.

That's it — write away.