깃헙 블로그 작성 규칙
Chirpy 기반 깃헙 블로그에서 글, 이미지, 동영상 등을 작성하는 기본 규칙 정리.
깃헙 블로그 작성 규칙
글 관리는 _posts 폴더에서
파일 이름은 반드시 연도-월-일-제목.md 형식
글을 지우려면 해당 파일을 삭제
Chirpy는 카테고리를 최대 2단계까지 지원
categories: [개발, 깃헙블로그]라고 쓰면 “개발”이 상위, “깃헙블로그”가 하위
아카이브는 글의 date(날짜)를 기준으로 연도·월별로 자동 정리
이미지 삽입
1
Chirpy는 여기에 더해 캡션, 크기, 정렬 같은 옵션을 붙일 수 있다.
이미지 바로 아래 줄에 이렇게 적는다.
1
2
3
4
5
6
_사진 아래 들어갈 캡션_
{: width="400" height="300" }
{: .normal }
외부 이미지 주소(URL)만 알면 저장소에 올리지 않고 경로 자리에 /assets/img/... 대신 그 이미지의 전체 주소를 넣어서 바로 본문에 넣을 수 있다.
캡션이나 크기 옵션도 그대로 쓸 수 있다.
1
2
3
{: width="400" }
_이미지 출처: example.com_
Chirpy에는 글마다 이미지 기준 경로를 한 번만 정해두면, 본문에서는 파일명만 써도 되는 기능이 있다. 글 머리말(front matter)에 media_subpath를 넣으면 된다.
1
2
3
4
5
6
7
8
9
10
11
12
---
title: 깃헙 블로그 시작하기
date: 2026-06-11 14:00:00 +0900
categories: [개발, 깃헙블로그]
tags: [jekyll, chirpy]
media_subpath: /assets/img/posts/2026-06-11-github-blog-start/
---
본문에서는 이렇게 짧게:
동영상 삽입
유튜브 영상이라면 본문에 이렇게 적는다.
1
{% include embed/youtube.html id='영상ID' %}
비슷하게 다른 플랫폼도 지원함.
1
2
{% include embed/twitch.html id='영상ID' %}
{% include embed/bilibili.html id='영상ID' %}
내가 직접 올린 동영상 파일(예: assets/video/clip.mp4)을 넣으려면 HTML 태그를 직접 쓴다. 마크다운 본문 안에 HTML을 써도 동작함.
1
2
3
<video controls width="100%">
<source src="/assets/video/clip.mp4" type="video/mp4">
</video>
이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.