Welcome! This repository is your blog. Every .md file you push to the posts/ folder is published live on pushblog.io.
Fork this repo to your GitHub account. Keep it public — private repositories are not supported.
Go to pushblog.io/github/setup and install the PushBlog GitHub App on your forked repository. This connects your repo to PushBlog automatically — no scripts or webhook configuration needed.
Copy the example post from drafts/ to posts/:
cp drafts/example-post.md posts/my-first-post.md
Fill in the frontmatter and write your content, then push:
git add posts/my-first-post.md
git commit -m "Add my first post"
git push origin main
Your post is live instantly at https://pushblog.io/<your-github-username>/<slug>.
Every post requires a frontmatter block at the top:
---
title: "My Post Title"
author: "Your Name"
date: "2025-06-01"
description: "Short summary for SEO and previews."
slug: "my-post-title"
tags: ["tag1", "tag2"]
---
Your content here...Note: The
slugand filename are immutable after publishing. Renaming them will break existing links.
posts/ ← published on every push
drafts/ ← ignored by PushBlog, use for work in progress
assets/ ← images you can reference from posts
Happy writing!