Dev.to
7/12/2026

How To Build A Personal Blog With MkDocs
Short summary
A detailed walkthrough of building a personal developer blog using MkDocs Material with uv for dependency management. Covers Markdown-based authoring, bilingual English/Chinese support with CJK search tokenization, GitHub Actions CI/CD for automatic deployment to GitHub Pages, custom Atom One Dark Pro-inspired theming, giscus comments, and Google Analytics 4 integration. Includes complete mkdocs.yml configuration and CSS overrides.
- •MkDocs Material blog with uv dependency management, bilingual EN/ZH support, and GitHub Actions deployment
- •Custom Atom One Dark Pro color palette with dark mode default and full CSS variable overrides
- •Integrates giscus comments, Google Analytics 4, RSS, and tag-based language filtering
Generated with AI, which can make mistakes.
Is this a good recommendation for you?



