A personal knowledge base and notes site built with Jekyll and hosted on GitHub Pages.
This site is my external brain — a place to collect thoughts, learnings, and technical notes. Everything is written in Markdown and published automatically via GitHub Pages.
The workflow is intentionally simple:
- Write a Markdown file in
_posts/ - Commit and push to GitHub
- Publish — GitHub Pages builds and deploys automatically
Each post needs YAML front matter at the top:
---
layout: post
title: "My Post Title"
date: 2026-10-28 16:00:00 +0100
categories: [notes, tech]
---# Install Ruby and Bundler (one-time)
gem install bundler
# Install dependencies
bundle install
# Serve locally
bundle exec jekyll serve
# View at http://localhost:4000- Create a repository named
blogon GitHub - Push your site files to the
mainbranch - Go to Settings → Pages
- Select "Deploy from branch" →
main→/root - Your site is live at
https://iridium87.github.io/blog/
# Create a new post file
touch _posts/YYYY-MM-DD-your-note.md
# Edit with your content, then:
git add .
git commit -m "Add post: Your Note Title"
git push/jekyll-blog
├── _config.yml # Site configuration
├── _layouts/ # HTML templates
├── _posts/ # Your blog posts (Markdown)
├── assets/ # CSS, images, etc.
├── index.md # Homepage
├── Gemfile # Ruby dependencies
└── README.md # This file
This site is for personal use. Feel free to use the structure as a template for your own Jekyll blog.