처음 글을 쓰려니 뭘 써야 하나 잠깐 멈칫하게 되는데, 역시 첫 글은 앞으로 계속 만지게 될 기본 구조를 정리하는게 제일 마음이 편하다.

이 블로그는 Hugo와 PaperMod 테마를 기준으로 글을 작성할 예정이라, Markdown 파일 맨 위에 들어가는 FrontMatter를 먼저 확인해보자. 글 하나 올릴 때마다 매번 보게 되는 부분이라 처음에 한번 정리해두면 나중에 덜 헷갈린다.

항상 최신 정보는 공식 문서를 참고하는게 좋은 습관이다.

PaperMod Page Variables 문서

1.FrontMatter 확인

YAML의 가장 윗 단에 있는 내용을 FrontMatter라고 부른다. Hugo는 이 영역을 읽어서 글 제목, 날짜, 요약, 태그 같은 메타데이터를 처리한다. PaperMod도 이 값을 기준으로 목록 화면, SEO 정보, 글 하단 태그 등을 만들어준다.

기본 모양은 아래와 같다.

YAML

---
title: "안녕하세요. 처음 인사드립니다."
description: "Hugo PaperMod에서 글을 작성할 때 가장 먼저 만나는 FrontMatter 기본값을 정리한다."
summary: "Hugo PaperMod FrontMatter 기본 변수 정리"
author: 김대원
date: 2026-06-15
tags:
  - hugo
  - papermod
  - markdown
  - frontmatter
---
---
title: "안녕하세요. 처음 인사드립니다."
description: "Hugo PaperMod에서 글을 작성할 때 가장 먼저 만나는 FrontMatter 기본값을 정리한다."
summary: "Hugo PaperMod FrontMatter 기본 변수 정리"
author: 김대원
date: 2026-06-15
tags:
- hugo
- papermod
- markdown
- frontmatter
---

중요

FrontMatter는 파일의 제일 위에 있어야 한다. ---로 시작하고 ---로 닫히지 않으면 Hugo가 글 내용을 제대로 읽지 못할 수 있다.

2.기본 변수 작성

몇가지 자주 쓰는 variable을 소개할까 한다. 모든 값을 매번 다 넣을 필요는 없지만, 최소한 title, date, summary, tags 정도는 꾸준히 넣어주는게 나중에 글이 많아졌을 때 관리하기 편하다.

2.1 title 작성

title은 글 제목이다. 목록 화면과 글 상세 화면에서 제일 먼저 보이는 값이라 너무 길게 쓰지 않는게 좋다.

YAML

title: "안녕하세요. 처음 인사드립니다."
title: "안녕하세요. 처음 인사드립니다."

제목은 검색 결과나 브라우저 탭에도 영향을 줄 수 있으니, 글의 내용을 바로 알 수 있게 적어주자. 멋을 너무 부리면 나중에 내가 검색할 때 내가 못 찾는 이상한 상황이 생긴다.

2.2 description 작성

description은 글을 한두 문장으로 설명하는 값이다. PaperMod에서는 SEO나 일부 메타 태그에 사용될 수 있으니, 가능하면 summary보다 조금 더 설명적으로 작성한다.

YAML

description: "Hugo PaperMod에서 글을 작성할 때 가장 먼저 만나는 FrontMatter 기본값을 정리한다."
description: "Hugo PaperMod에서 글을 작성할 때 가장 먼저 만나는 FrontMatter 기본값을 정리한다."

여기서 중요한 것은 본문 첫 문장을 그대로 복사하는게 아니라, 이 글이 왜 필요한지를 짧게 정리하는 것이다. 기계도 읽고 사람도 읽는 값이라고 생각하면 된다.

2.3 summary 작성

summary는 글 목록에서 보여줄 짧은 요약이다. description보다 더 짧고, 사람이 목록에서 훑어볼 때 도움이 되는 정도면 충분하다.

YAML

summary: "Hugo PaperMod FrontMatter 기본 변수 정리"
summary: "Hugo PaperMod FrontMatter 기본 변수 정리"

요약은 너무 길게 쓰지 말자. 목록 화면에서 줄이 길어지면 모양도 애매하고, 결국 아무도 끝까지 안 읽는다.

2.4 date 작성

date는 글 작성일이다. Hugo는 이 값을 기준으로 글 정렬이나 발행 시간을 처리한다.

YAML

date: 2026-06-15
date: 2026-06-15

날짜는 가능하면 YYYY-MM-DD 형식으로 통일한다. 시간이 필요한 글이면 ISO 형식까지 넣을 수 있지만, 일반적인 블로그 글은 날짜만 있어도 충분하다.

2.5 tags 작성

tags는 글을 분류하기 위한 값이다. 나중에 관련 글을 찾거나 특정 주제만 모아서 볼 때 꽤 유용하다.

YAML

tags:
  - hugo
  - papermod
  - markdown
  - frontmatter
tags:
- hugo
- papermod
- markdown
- frontmatter

태그는 대소문자와 띄어쓰기를 섞어 쓰면 나중에 관리하기 귀찮아진다. 가능하면 lowercase English로 맞춰두자. 사소해 보이지만 이런 사소한 것들이 쌓이면 검색이 편해진다.

3.작성 규칙 정리

FrontMatter는 자유도가 높지만, 자유도가 높다는 말은 곧 내가 나중에 망칠 수 있다는 뜻이기도 하다. 그래서 이 블로그에서는 아래 정도의 규칙만 가볍게 지키려고 한다.

변경하지 않고 계속 가져갈 값

author
tags 형식
date 형식

글마다 바꿔야 하는 값

title
description
summary
tags 내용

팁

새 글을 만들 때는 이전 글의 FrontMatter를 복사한 다음 필요한 값만 바꾸는게 제일 편하다. 단, date를 안 바꾸고 올리는 실수는 은근히 자주 하니 한번 더 확인해주자.

4.다음 단계

이제 기본 FrontMatter는 정리했으니, 다음 글부터는 실제로 Markdown 본문을 어떻게 구성할지 정리하면 된다. 제목, 코드 블록, 이미지, 링크 같은 것들을 일정한 규칙으로 써두면 글을 쓰는 속도도 빨라지고 나중에 옮겨 담기도 편해진다.