Back to feed
Dev.to
Dev.to
7/12/2026
How To Build A Personal Blog With MkDocs

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?

Comments

Failed to load comments. Please try again.

Explore more