# 🚀 MkDocs Material 블로그 배포 가이드

MkDocs Material 테마로 블로그를 운영할 때,  
로컬 환경에서 수정 후 GitHub Pages로 반영하는 전체 과정을 정리했습니다.

---

## 1️⃣ 가상환경 활성화

# (있다면) 가상환경 활성화

.venv\Scripts\Activate

##  2️⃣ Material 테마 최신 버전 설치/업데이트

pip install mkdocs-material --upgrade

## 3️⃣ 로컬에서 블로그 확인

mkdocs serve

👉 http://127.0.0.1:8000 접속해서 테마/수정사항 반영 확인

4️⃣ GitHub Pages 배포

mkdocs gh-deploy --force

5️⃣ 변경 사항 GitHub에 커밋 & 푸시

git add -A
git commit -am "blog edit commit"
git push origin main

필요 시 강제 푸시:

git push origin main --force

## ✅ 정리

가상환경 실행 → Activate

Material 업데이트 → pip install ...

로컬 테스트 → mkdocs serve

배포 실행 → mkdocs gh-deploy

GitHub 푸시 → git push origin main

### 이 순서대로 하면 MkDocs 블로그 수정 → 배포 → GitHub 반영까지 원활히 진행됩니다 🚀