Jekyll Documentation¶

Technical documentation for Jekyll development with the Zer0-Mistakes theme.

Getting Started¶

Guide	Description	Time
Theme Guide	Complete setup and customization guide	30 min
Netlify Deployment	Deploy to Netlify with CI/CD	15 min
Custom Domain	Set up your own domain	20 min

Features & Integrations¶

Comments & Analytics¶

Guide	Description	Difficulty
Giscus Comments	GitHub Discussions-powered comments	Beginner
PostHog Analytics	Privacy-first analytics	Intermediate

Content Enhancement¶

Guide	Description	Difficulty
Mermaid Diagrams	Flowcharts, sequence diagrams, and more	Beginner
MathJax Formulas	Mathematical notation	Beginner
Code Highlighting	Syntax highlighting for code	Beginner

Development¶

Guide	Description	Difficulty
Liquid Templating	Liquid template language reference	Intermediate
Pagination	Add navigation between posts	Beginner
Security Headers	Harden your site with proper headers	Intermediate

Quick Reference¶

Development Commands¶

# Start development server (Docker)
docker-compose up

# Start development server (Ruby)
bundle exec jekyll serve --config "_config.yml,_config_dev.yml"

# Build for production
bundle exec jekyll build

# Check configuration
bundle exec jekyll doctor

Essential Front Matter¶

---
title: "Page Title"
description: "SEO description (150-160 chars)"
layout: default  # or journals, home
date: 2026-01-24T00:00:00.000Z
categories: [Category]
tags: [tag1, tag2]
permalink: /custom-url/

# Feature flags
mermaid: true    # Enable Mermaid diagrams
mathjax: true    # Enable MathJax formulas
comments: false  # Disable Giscus comments
---

Project Structure¶

zer0-mistakes/
├── _config.yml          # Production config
├── _config_dev.yml      # Development overrides
├── _layouts/            # Page templates
├── _includes/           # Reusable components
├── _sass/               # Stylesheets
├── assets/              # Static files
├── pages/_posts/        # Blog posts
├── pages/_docs/         # Documentation
└── docs/jekyll/         # Technical docs (you are here)

External Resources¶

Part of the Zer0-Mistakes Jekyll Theme documentation.