How to Publish

1. Get a GitHub account

If you don't already have one, sign up at github.com. It's free and takes about a minute.

2. Write your post

Write your post anywhere you like — Google Docs, Notes, Word, a napkin you later transcribe. When you're happy with it, you'll need to convert it to Markdown.

Markdown is a simple way to format text using plain characters. For example, **bold** becomes bold and ## Heading becomes a heading.

Don't want to learn Markdown? Ask any AI (ChatGPT, Claude, Gemini, etc.):

"Convert this text into Markdown format for a blog post"

Paste your text, and it'll hand you back a clean Markdown version ready to go.

3. Add a small header

Every post needs a few lines at the very top called frontmatter. It tells the site your post's title, date, and who wrote it. Just copy this and fill in your details:

---
title: "Your Post Title"
description: "A one-sentence summary of your post."
date: 2026-03-15
author: "Your Name"
---

Your Markdown content goes here...

4. Submit it

This is the "pull request" part. It sounds technical, but GitHub makes it pretty simple:

1. Go to the posts folder in the repo
2. Click Add file → Create new file
3. Name it something like my-post-title.md (this becomes the URL)
4. Paste your frontmatter + Markdown content
5. Click Commit changes — GitHub will ask you to fork the repo (say yes)
6. Click Create pull request

That's it. Once the pull request is reviewed and merged, your post goes live.

5. Optional: add a cover image

Want an image at the top of your post? Upload it to the images folder in the same pull request, then add this line to your frontmatter:

image: /images/your-image.jpg

Recommended size: 1200x630px. This also shows up as a preview when the link is shared.