고스트 블로그 대표 이미지가 너무 클 때 줄이는 방법 (Code Injection)
목차 보기
고스트(Ghost) 블로그에 글을 발행했더니 글 상단의 대표 이미지(Feature Image)가 화면을 가득 채울 만큼 크게 나왔습니다. 글보다 이미지가 더 눈에 띄어서 크기를 줄이고 싶었는데, 생각보다 여러 번 돌아가야 했습니다.
업데이트 (2026년 7월 30일)
이 글은 고스트를 사용하던 당시 실제로 적용한 해결 방법입니다. 현재 minml은 Astro로 이전했지만, 같은 문제를 겪는 고스트 사용자를 위해 기록을 남겨둡니다. 이후의 운영 변화는 고스트에서 Astro로 옮긴 후기에 정리했습니다.
대표 이미지를 빼면 생기는 문제
처음에는 단순하게 생각했습니다. 대표 이미지를 등록하지 말고 본문 안에 이미지를 넣으면 되지 않을까 싶었습니다.
실제로 본문에 이미지를 넣으니 크기는 적당했습니다. 그런데 메인(글 목록) 화면에서 썸네일이 사라졌습니다. 제가 쓰던 테마는 글 목록의 썸네일을 대표 이미지에서 가져왔고, 본문 안의 이미지는 썸네일로 잡히지 않았습니다.
- 대표 이미지를 등록하면 → 목록 썸네일은 나오지만, 글 상단 이미지가 너무 크다
- 본문에만 이미지를 넣으면 → 크기는 적당하지만, 목록 썸네일이 빈다
그래서 방향을 바꿨습니다. 대표 이미지는 등록하되, 글 상단에 크게 나오는 부분만 CSS로 줄이기로 했습니다.
테마 CSS를 고쳐도 반영되지 않은 이유
대표 이미지를 감싸는 CSS는 테마 파일 안에 있었습니다. 찾아보니 이런 코드였습니다.
.gh-article-image img {
width: 100%;
}
여기에 높이 제한을 추가했습니다.
.gh-article-image img {
width: 100%;
max-height: 400px;
object-fit: cover;
}
그런데 저장하고 새로고침해도 사이트에는 전혀 반영되지 않았습니다. 한참 헤매다가 CSS 파일 맨 위 주석에서 단서를 찾았습니다. 요약하면 “이 파일은 개발용 원본이고, 실제 사이트는 압축된 빌드본(built 폴더 안의 파일)을 읽는다”는 내용이었습니다.
제가 고친 것은 원본 소스 파일이었고, 실제 사이트가 읽는 파일은 따로 빌드된 압축본이었습니다. 원본을 고친 뒤 빌드를 다시 돌려야 반영되는 구조였는데, 그러려면 테마 개발 환경을 갖춰야 했습니다. 더 간단한 방법을 찾기로 했습니다.
Code Injection으로 덮어쓰기
그 방법이 Code Injection이었습니다. 고스트 관리자 화면의 Settings → Advanced → Code Injection 메뉴에는 Site Header와 Site Footer 두 칸이 있습니다. 제가 쓰던 Ghost 6에서 이 경로로 적용했고, 2026년 9월 26일 Ghost 공식 도움말에서도 같은 메뉴 위치를 확인했습니다. Site Header에 넣은 코드는 모든 페이지의 <head> 안에 들어가므로, 테마 빌드를 건드리지 않고 기존 스타일 위에 덮어쓸 수 있습니다. 테마 원본을 수정하지 않으니 테마를 업데이트해도 유지하기 쉽습니다.
Site Header에 이렇게 넣었습니다.
<style>
.gh-article-image img {
max-height: 400px;
object-fit: cover;
}
</style>
저장하고 글 페이지를 새로고침하니 드디어 적용됐습니다.
Code Injection은 CSS 전용 칸이 아니라 <head>에 들어가는 HTML을 넣는 곳입니다. 그래서 CSS는 반드시 <style>...</style> 태그로 감싸야 합니다. Ghost 도움말의 예시도 모두 이렇게 감싸져 있습니다.
이미지가 잘리는 문제
적용은 됐는데 이번에는 이미지가 위아래로 잘려서 나왔습니다.
이것은 object-fit: cover의 정상적인 동작입니다. 정해진 높이(400px)를 꽉 채우면서 넘치는 부분을 잘라냅니다. 썸네일처럼 일부만 보여줄 때는 유용하지만, 이미지 전체를 보여주고 싶을 때는 맞지 않습니다.
저는 이미지 전체가 보이길 원했습니다. 그래서 높이를 자르는 대신 최대 폭을 줄여서 전체적으로 작게 만들었습니다.
<style>
.gh-article-image img {
display: block;
max-width: 720px;
margin: 0 auto;
}
</style>
이렇게 하니 이미지가 원본 비율 그대로, 잘림 없이, 가운데 정렬되어 적당한 크기로 나왔습니다. 폭(720px)을 600~800 사이에서 바꿔가며 원하는 크기를 찾으면 됩니다.
- 일정한 높이로 잘라 맞추고 싶다 →
max-height+object-fit: cover - 잘리지 않게 전체를 작게 보여주고 싶다 →
max-width로 폭 조절
테마마다 다른 선택자
.gh-article-image는 제가 쓰던 테마에서 확인한 선택자입니다. Ghost 기본 테마인 Source의 현재 코드에서도 대표 이미지는 gh-article-image 클래스를 가진 figure 안에 있어서 같은 선택자가 통합니다(2026년 9월 26일 확인). 다른 테마는 HTML 구조와 클래스 이름이 다를 수 있으므로, 그대로 적용되지 않는다면 브라우저 개발자 도구로 대표 이미지의 선택자를 먼저 확인해야 합니다.
사이트 전체에 넣기 전에 시험해보고 싶다면 글 하나에서 먼저 적용할 수 있습니다. 편집기의 Post Settings 메뉴에도 해당 글에만 적용되는 Code Injection이 있습니다.
워드프레스 추가 CSS와 비교
워드프레스를 써본 입장에서 Code Injection은 사용자 정의하기 → 추가 CSS와 거의 같은 역할이었습니다. 테마 원본은 그대로 두고 그 위에 덮어쓰기 때문에 테마를 업데이트해도 넣은 스타일이 유지된다는 점도 같았습니다.
차이는 하나입니다. 워드프레스의 추가 CSS에는 CSS만 바로 입력하지만, 고스트의 Code Injection은 <head>에 들어가는 HTML 영역이라 <style> 태그로 감싸야 합니다. 이것만 기억하면 워드프레스에 익숙한 분도 어렵지 않게 쓸 수 있습니다.
참고한 자료
2026년 9월 26일 확인