클릭 한 번으로 내 사이트 올리기

GitHub Pages

GitHub 저장소를 웹사이트로 변환합니다.
Jekyll 테마를 적용하고, 홈페이지를 꾸미고,
블로그 게시물까지 작성해 봅니다.

GitHub Pages는 GitHub 저장소의 파일을 자동으로 웹사이트로 변환해주는 무료 호스팅 서비스입니다.

별도의 서버나 도메인 없이도 실제 URL로 접속되는 사이트를 만들 수 있습니다.

• 포트폴리오 — 개인 이력서/프로젝트 소개
• 프로젝트 문서 — API 문서, 가이드
• 블로그 — Jekyll을 활용한 정적 블로그
• 무료 — 퍼블릭 저장소에서 완전 무료

Jekyll은 마크다운 파일을 HTML 웹사이트로 변환하는 정적 사이트 생성기입니다. GitHub Pages에 기본 내장되어 있습니다.

Jekyll의 장점

• 설치 불필요 — GitHub Pages가 자동으로 빌드
• 테마 지원 — 한 줄로 사이트 디자인 변경
• 마크다운 지원 — .md 파일만 작성하면 됨
• 블로그 기능 — _posts/ 폴더로 자동 블로그

index.md 파일이 사이트의 메인 페이지가 됩니다. 마크다운 문법으로 자유롭게 내용을 편집할 수 있습니다.

---
title: Welcome to my blog
---

# 안녕하세요! 👋
이것은 나의 GitHub Pages 사이트입니다.

홈페이지에 넣을 수 있는 것들

• 자기 소개 — 이름, 관심 분야
• 프로젝트 목록 — 링크와 설명
• 이미지 — 프로필 사진, 스크린샷

_config.yml은 Jekyll 사이트의 전체 설정을 담는 파일입니다.

theme: minima
title: "내 블로그"
author: "홍길동"
description: "GitHub Pages로 만든 블로그"
timezone: Asia/Seoul

주요 설정 항목

• theme — 사이트 디자인 테마 선택
• title — 사이트 제목 (브라우저 탭에 표시)
• description — 사이트 설명 (SEO)
• timezone — 날짜 처리 시간대

Jekyll은 _posts/ 폴더의 마크다운 파일을 자동으로 블로그 게시물로 변환합니다.

파일 이름 규칙

_posts/YYYY-MM-DD-제목.md

예시:
_posts/2026-04-05-my-first-post.md

• 날짜는 반드시 YYYY-MM-DD 형식
• 제목의 단어 사이에 하이픈(-) 사용
• 날짜 형식이 잘못되면 빌드 에러 발생

Front Matter는 마크다운 파일 최상단에 위치하는 ---로 감싼 YAML 설정 블록입니다.

---
title: "내 블로그에 오신 것을 환영합니다"
date: 2026-04-05
---

여기부터 본문 내용을 작성합니다...

주요 Front Matter 항목

• title — 게시물 제목 (페이지에 표시)
• date — 게시물 날짜 (YYYY-MM-DD)
• layout — 사용할 레이아웃 템플릿