MkDocs & Site Building Hub¶
Everything about building static sites with MkDocs and GitHub Pages.
Most-read guides¶
Embed flowcharts and sequence diagrams in MkDocs - Design Improvements
Advanced Material theme features and custom CSS - Advanced Configuration
Plugins, i18n, and CI/CD pipeline setup - Plugins Guide
Free plugin selection and practical combination patterns
Guides by category¶
Getting Started¶
- Building GitHub Pages with MkDocs — Full setup-to-deploy walkthrough
- HTML Direct Publish in MkDocs — Host non-Markdown HTML alongside your docs
- Site Operations Guide — Day-to-day update and maintenance workflow
Design & Customization¶
- Design Improvement Guide — Material theme UI/UX enhancements
- Mermaid Diagram Setup Guide — Embed flowcharts and ER diagrams
- Multilingual Setup — Build a multi-language site with i18n plugin
- Meta Description Setup Guide — Manage SEO meta information
Plugins¶
- MkDocs Free Plugins Guide — Curated plugin setup and configuration
- Plugins Showcase — Plugin comparisons and use cases
- git-revision-date Troubleshooting — Fix date plugin issues
Advanced¶
- Advanced Configuration — Plugins, search, CI/CD pipelines
- Live2D Character Integration — Add interactive characters to your site
Automation & Operations¶
- GitHub Actions Auto Deploy — Auto-build and deploy on push
- Analytics Setup — GA4 integration and privacy compliance
Learning path¶
- Brand new? Start with Building GitHub Pages with MkDocs
- Better looks: Design Improvement Guide for UI polish
- Add diagrams: Mermaid Setup Guide for visual content
- Go pro: Advanced Configuration + Plugins for full power