MkDocs + GitHub Pages Deployment with GitHub Actions

Overview

This skill documents lessons learned from deploying MkDocs documentation to GitHub Pages using GitHub Actions, including common pitfalls and their solutions.

GitHub Pages Deployment Methods

Method 1: Legacy mkdocs gh-deploy (Deprecated)

- name: Deploy to GitHub Pages
  run: mkdocs gh-deploy --force --clean --verbose