Hello, world: how this blog is built

A static site written in Obsidian, built with Astro and served from Cloudflare Pages. No database, no admin panel, nothing to patch.

After 15 years of running other people’s servers, I wanted a place for my own notes that needs no server at all. This blog is a folder of Markdown files. Everything else is generated.

The pipeline

From a note to a published page
From a note to a published page
  1. I write a note in Obsidian. The vault is the content/ folder of the repository.
  2. A push to GitHub triggers a build on Cloudflare Pages.
  3. Astro turns Markdown into plain HTML and CSS. A minute later the post is live.

What a post looks like

Every post starts with a few properties:

---
title: "My post"
description: "One or two sentences for the list page and search engines."
date: 2026-11-09
tags: [linux, storage]
draft: true
---

The file name becomes the address: my-post.md is published at /blog/my-post/.

Why static

Static site Classic CMS
Attack surface Files on a CDN PHP, plugins, database
Backups git clone Database dumps plus uploads
Page weight A few kilobytes Depends on the theme
Cost Free tier A server to maintain