← Back to Posts
Setup a minimal blog site using Github Pages

Setup a minimal blog site using Github Pages

Updated Nov 5, 2025 · Created Nov 5, 2025

Steps

  1. Having a Github account
  2. Follow skills/github-pages to learn Github Pages
  3. Create a public repository called <yourusername>.github.io
  4. Make sure Github Pages for this repo is enabled
  5. Add _config.yml onto the main branch
  6. Add index.md onto the main branch
  7. Put a markdown as a new post under _posts
  8. Ensure the 3 files are properly configured
  9. Now visit your new blog site at https://<yourusername>.github.io

Issues

Visiting the site and 404 displayed

404 error

Fix: At least add theme frontmatter to the index file.

Written blog not displayed

Blog not displayed

Fix:

  • Make sure _config.yml with theme is configured
  • Make sure posts use "-" for separators
  • Beware that if time zones are correct