McGarrah Technical Blog

Jekyll Mermaid Diagram Rendering: Why Client-Side Beats Plugins

5 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

7 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

8 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

11 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