깃허브 프로필에 들어갔을 때 “Hi there 👋”이라고 적힌 녹색 박스가 뜨는 사람이 있고, 아무것도 없는 사람이 있습니다. 그 차이가 바로 프로필 README입니다.
취업용 포트폴리오든, 단순히 깔끔하게 꾸미고 싶은 거든 — 10분이면 만들 수 있어요.
프로필 README가 뭔가요?
GitHub에는 사용자명과 동일한 이름의 저장소를 만들면 해당 저장소의 README.md가 프로필 메인 페이지에 표시되는 특별 기능이 있습니다.
- 사용자명이 “hong”이면 →
hong/hong저장소의 README.md가 프로필에 노출 - 마크다운으로 작성 → HTML, 이미지, 뱃지 등 자유롭게 구성 가능
- 방문자가 내 프로필에 올 때 첫인상을 결정하는 요소
1단계: 특별 저장소 만들기
- GitHub → “+” → New repository
- Repository name: 본인 사용자명과 정확히 동일하게 입력
- GitHub가 “You found a secret!” 메시지를 보여줌 — 이게 뜨면 맞게 입력한 것
- Public 선택 + “Add a README file” 체크
- Create repository
생성 즉시 프로필 페이지에 README가 표시됩니다.
2단계: README 기본 구조
아래 템플릿을 복사해서 README.md에 붙여넣으세요. 내용만 수정하면 됩니다.
# 안녕하세요! 👋
저는 **[이름]**입니다. [한 줄 소개].
## 🛠 기술 스택



## 📊 GitHub Stats

## 📫 연락처
- 이메일: example@email.com
- 블로그: [링크](URL)
꾸미기 요소 모음
기술 스택 뱃지
shields.io에서 뱃지를 만들 수 있습니다. 자주 쓰는 뱃지:
| 기술 | 마크다운 코드 |
|---|---|
| Python |  |
| Java |  |
| React |  |
| Node.js |  |
| AWS |  |
팁: simpleicons.org에서 로고명을 확인할 수 있어요.
GitHub 통계 카드
기본 통계:

가장 많이 쓴 언어:

연속 커밋(스트릭):

잔디(Contribution) 그래프
기본 잔디 그래프는 프로필에 자동으로 보이지만, 더 예쁘게 꾸미려면:

방문자 카운터

포트폴리오용 프로필 — 이것만은 넣으세요
취업이나 이직용으로 프로필을 꾸민다면 아래 항목을 권장합니다:
- 한 줄 소개 — 직무 + 관심 분야 (예: “백엔드 개발자, 분산 시스템에 관심”)
- 기술 스택 뱃지 — 실제로 쓸 수 있는 기술만. 과장 금지
- 대표 프로젝트 2~3개 — 저장소 링크 + 한 줄 설명
- GitHub 통계 — 활동량 증명
- 연락처 — 이메일 또는 LinkedIn
너무 많은 요소를 넣으면 오히려 산만합니다. 깔끔하고 핵심만 담는 게 좋아요.
참고할 만한 프로필 예시 사이트
- Awesome GitHub Profile README — 수백 개의 프로필 예시 모음
- GitHub Profile README Generator — 질문에 답하면 마크다운 자동 생성
- GPRM — 클릭만으로 프로필 생성
정리
- 사용자명과 동일한 저장소 만들면 프로필 README 활성화
- 뱃지(shields.io) + 통계 카드 + 잔디 그래프로 시각적 꾸미기
- 포트폴리오용이면 소개 + 기술 + 대표 프로젝트 + 연락처 필수
- 자동 생성 도구를 쓰면 5분 만에 완성 가능
이 글은 2026년 7월 기준으로 작성되었습니다.
같은 주제 글 보기