2026-06-16

Hexo와 GitHub Pages로 기술 블로그 시작하기

이 글은 Hexo와 GitHub Pages로 기술 블로그를 만드는 과정을 기록한 첫 번째 글이다.

목표

블로그 소스는 별도 저장소에서 관리하고, Hexo가 생성한 정적 파일만 GitHub Pages에 배포한다.

사용한 구성은 다음과 같다.

1
2
3

Node.js v22.22.1
npm 10.9.4
Git 2.51.1.windows.1

npx hexo-cli init Reasonofmoon.github.io
cd Reasonofmoon.github.io
npm install
npm install hexo-deployer-git --save

_config.yml에는 사이트 주소와 배포 대상 브랜치를 설정했다.

url: https://Reasonofmoon.github.io

deploy:
  type: git
  repo: https://github.com/Reasonofmoon/Reasonofmoon.github.io.git
  branch: gh-pages

1
2
3

npx hexo clean
npx hexo generate
npx hexo deploy

앞으로 새 글을 쓸 때는 source/_posts 아래의 Markdown 파일을 수정하고, 로컬에서 확인한 뒤 배포하면 된다.