Jekyll Mermaid Diagram Rendering: Why Client-Side Beats Plugins

By Michael McGarrah · December 15, 20256 min read

How Jekyll 4.4's Rouge syntax highlighter interferes with Mermaid diagram rendering and why client-side rendering with Mermaid 11 is better than plugins.

SASS Circular Dependency Nightmare: Lessons from Jekyll Architecture

By Michael McGarrah · December 14, 20258 min read

How a simple print stylesheet addition turned into a deep dive into SASS module architecture and the perils of circular dependencies.

Adding Google Custom Search to Jekyll Website

By Michael McGarrah · December 07, 20259 min read

How to implement Google Custom Search Engine (CSE) on a Jekyll website hosted on GitHub Pages for better content discoverability.

Jekyll Website Optimization for GitHub Pages - Part 2

By Michael McGarrah · November 30, 202511 min read

In Part 1 of this series, we covered the foundational optimizations for Jekyll sites on GitHub Pages. Part 2 dives into advanced analytics, performance monitoring, and the lessons learned from running a technical blog with 100+ posts.

Posts

2025-12-15 Jekyll Mermaid Diagram Rendering: Why Client-Side Beats Plugins
2025-12-14 SASS Circular Dependency Nightmare: Lessons from Jekyll Architecture
2025-12-07 Adding Google Custom Search to Jekyll Website
2025-11-30 Jekyll Website Optimization for GitHub Pages - Part 2