Hexo, Hugo, Astro ๐Ÿš€


I originally chose Hugo because it was stable and well-structured.
It worked well for writing and organizing content.
But over time, the site slowly turned into Markdown mixed with a lot of HTML and shortcodes, which made the content harder to maintain.

I explored a few other options along the way, including Sveltia, Decap, Publii, and Ghost.
I also briefly tried adding a CMS layer, but it quickly felt unnecessary for how I actually use this site.

What I wanted to keep was simple: GitHub hosting, with the flexibility to customize both pages and the blog, without introducing extra tooling to maintain.

Astro felt like a better fit for keeping content and layout loosely coupled, without adding more abstraction โœจ

The hardest parts of this migration were:

  • Converting Hugo shortcodes ๐Ÿงฉ
  • Figuring out how to migrate with minimal changes, without rewriting the whole theme ๐Ÿงฑ
  • Summary handling (Hugo more vs Astro) โœ‚๏ธ

Many problems were not technical, but about deciding what to keep and what to let go.

For now, the goal was to get everything working again with a clean structure.
Next, Iโ€™m planning to re-theme the site and clean up some old decisions ๐ŸŽจ