Github 블로그에 포스팅하는 방법
GitHub 블로그에 Markdown 으로 게시물 작성하기
GitHub Pages와 Jekyll을 활용하면 무료로 블로그를 만들고 관리할 수 있습니다. 특히 Jekyll은 Markdown 파일을 지원하므로 간단한 문법으로 손쉽게 게시물을 작성할 수 있습니다. 이 글에서는 원하는 Jekyll 스킨을 활용해 블로그를 만드는 방법과 Markdown 파일을 사용해 게시물을 작성하는 방법을 소개합니다.
1. Jekyll 스킨 Fork로 블로그 생성하기
Jekyll은 다양한 테마와 스킨을 제공합니다. 원하는 스킨을 선택한 후 Fork를 통해 자신의 GitHub 저장소로 복사하면 간단히 블로그를 시작할 수 있습니다.
단계별 가이드
- Jekyll Themes 사이트에서 마음에 드는 스킨을 선택합니다.
- 스킨의 GitHub 저장소로 이동한 후
Fork
버튼을 클릭하여 자신의 저장소로 복사합니다. Fork한 저장소를 로컬에 클론합니다.
1
git clone https://github.com/사용자명/저장소명.git
저장소 디렉터리로 이동합니다.
1
cd 저장소명
- 필요하면
_config.yml
파일을 수정하여 블로그의 기본 설정을 변경합니다.
2. Markdown 파일로 게시물 작성하기
Jekyll 블로그의 게시물은 _posts
디렉터리에 저장됩니다. 각 게시물은 Markdown 파일로 작성되며, 파일 이름과 내용은 다음과 같은 형식을 따라야 합니다.
파일 이름 규칙
1
YYYY-MM-DD-파일-이름.md
예를 들어, 2025년 1월 22일에 “블로그 시작하기”라는 제목의 게시물을 작성하려면 다음과 같은 이름으로 파일을 저장합니다.
1
2025-01-22-블로그-시작하기.md
YAML 프론트 매터 작성
Markdown 파일의 첫 부분에는 YAML 프론트 매터(Front Matter)를 작성해야 합니다. 아래는 기본 예시입니다.
1
2
3
4
5
6
7
---
layout: post
title: "블로그 시작하기"
date: 2025-01-22 10:00:00 +0900
categories: [블로그]
tags: [jekyll, github]
---
본문 작성하기
YAML 프론트 매터 아래에 Markdown 문법으로 본문을 작성합니다. 예를 들어:
1
2
3
4
5
6
7
8
9
10
11
12
# Jekyll 블로그 시작하기
Jekyll은 정적 사이트 생성기로, Markdown 형식으로 간단하게 글을 작성할 수 있습니다.
## 주요 기능
- **Markdown 지원**: 쉽고 간결한 문법으로 글을 작성할 수 있습니다.
- **다양한 테마**: 원하는 테마를 선택하여 블로그를 꾸밀 수 있습니다.
코드 예시는 다음과 같이 작성합니다.
```ruby
puts "Hello, Jekyll!"
```
3. 게시물 미리보기와 배포하기
로컬에서 미리보기
로컬 환경에서 작성한 게시물을 확인하려면 다음 명령어를 실행하세요.
1
bundle exec jekyll serve
브라우저에서 http://localhost:4000
을 열어 미리보기를 확인할 수 있습니다.
GitHub에 배포하기
게시물이 준비되었다면 GitHub에 푸시하여 배포합니다.
변경된 파일을 확인합니다.
1
git status
변경 내용을 스테이징합니다.
1
git add _posts/2025-01-22-블로그-시작하기.md
커밋 메시지를 작성합니다.
1
git commit -m "Add new post: 블로그 시작하기"
원격 저장소로 푸시합니다.
1
git push origin main
GitHub Pages는 푸시된 내용을 자동으로 빌드하여 블로그에 반영합니다.
마치며
이제 Jekyll과 GitHub Pages를 활용해 간단히 블로그를 운영하고 Markdown 파일로 게시물을 작성하는 방법을 알게 되셨습니다. Jekyll의 다양한 테마와 플러그인을 활용해 나만의 블로그를 꾸며보세요!