Frontmatter - 프런트매터가 뭐지?

개요

참고. 아이디어와 초안 정리후 클로드코드로 생성했습니다.

프로그래밍을 하다 보면 문서 상단에 ---로 감싼 YAML 블록을 마주치게 됩니다. Jekyll, Hugo, Astro 같은 정적 사이트 생성기를 써본 분이라면 익숙한 그 영역, 바로 프런트매터(Frontmatter)입니다.

이 용어가 개발자들이 만들어낸 신조어라고 생각하기 쉽지만, 사실은 수백 년 된 출판·인쇄 업계의 전문 용어를 그대로 빌려온 것입니다.

---

단어의 구성: Front + Matter

어원은 단순합니다. 앞(Front)에 있는 내용물(Matter)이라는 뜻의 결합어입니다.

여기서 'Matter'는 일상적인 "문제"라는 뜻이 아니라, 인쇄 업계에서 쓰이는 의미로 원고, 활자로 조판된 내용물을 가리킵니다. 지금도 영어권 출판 편집자들은 "printed matter(인쇄물)"라는 표현을 자연스럽게 씁니다.

따라서 Front Matter는 "책의 본문이 시작되기 전, 맨 앞에 배치되는 모든 페이지"를 통칭하는 말입니다.

---

전통적인 책의 세 부분

편집 디자인에서는 한 권의 책을 크게 세 영역으로 나눕니다.

Front Matter (앞부속, 전문前文) — 속표지(half title), 본표지(title page), 저작권 페이지, 헌사, 서문, 목차 등 본문에 들어가기 전의 안내 역할을 하는 페이지들입니다.

Body / Text (본문) — 제1장부터 시작되는 책의 핵심 내용입니다. 일부 편집 가이드에서는 "Body Matter"라고도 하지만, 시카고 매뉴얼 오브 스타일(The Chicago Manual of Style) 등 주요 편집 표준에서는 단순히 "Text"라고 표현하는 경우가 더 많습니다.

Back Matter / End Matter (뒷부속, 후문後文) — 부록, 주석, 참고문헌, 색인(Index), 저자 소개 등 본문 뒤에 오는 보충 자료입니다.

---

로마 숫자의 비밀: "격리된 영역"이라는 설계 철학

오래된 학술서나 문학 전집을 펼쳐보면 재미있는 패턴을 발견할 수 있습니다. 본문은 아라비아 숫자 1, 2, 3...으로 페이지를 매기는데, 그 앞의 프런트매터는 소문자 로마 숫자 i, ii, iii...를 씁니다.

이렇게 나누는 이유가 실용적입니다. 책이 인쇄에 들어갈 때, 서문이나 목차는 본문보다 나중에 최종 확정되는 경우가 많습니다. 페이지 번호 체계를 분리해 두면, 프런트매터의 분량이 바뀌더라도 본문의 페이지 번호를 전부 다시 매길 필요가 없습니다.

본문과 독립적으로 관리되는 별도의 영역 — 이 설계 철학이 프로그래밍에서의 프런트매터와 놀라울 정도로 닮아 있습니다.

---

출판에서 코드로: 왜 개발자들이 이 용어를 가져왔을까

2008년, GitHub의 공동 창립자인 톰 프레스턴-워너(Tom Preston-Werner)가 Jekyll이라는 정적 사이트 생성기를 만들었습니다. Markdown으로 블로그 글을 쓰되, 각 파일에 제목·날짜·카테고리 같은 메타데이터를 기록할 영역이 필요했습니다.

이때 차용한 개념이 바로 책의 프런트매터입니다.

---
layout: post
title: "Blogging Like a Hacker"
date: 2008-10-19
categories: [jekyll, blogging]
---

여기서부터 본문이 시작됩니다.

• --로 감싼 YAML 블록이 프런트매터, 그 아래가 본문입니다.
• 책의 프런트매터: "이 책의 저자는 누구이고, 언제 출판되었으며, 어떤 구성인가?"
• 코드의 프런트매터: "이 파일의 제목은 무엇이고, 어떤 레이아웃을 쓰며, 어떤 카테고리에 속하는가?"

역할이 정확히 대응합니다. 본문이 시작되기 전에 해당 콘텐츠의 신원 정보를 기록하는 명찰 역할이라는 점에서, 이 용어 선택은 대단히 적확했습니다.

Jekyll이 대중화한 이 관행은 이후 Hugo, Hexo, Gatsby, Astro, Next.js 등 거의 모든 정적 사이트 생성기로 퍼져 나가며, 프런트매터는 웹 개발의 사실상 표준(de facto standard)이 되었습니다.

---

표기법: Front Matter vs. Frontmatter

흥미로운 차이가 하나 있습니다.

전통적인 출판계에서는 "front matter"라고 두 단어로 띄어 씁니다. 시카고 매뉴얼 오브 스타일을 비롯한 주요 편집 표준이 이 표기를 따릅니다. 다만 출판계에서도 "frontmatter"로 붙여 쓰는 사례가 완전히 없지는 않습니다.

반면 프로그래밍 세계에서는 "frontmatter"로 붙여 쓰는 경우가 압도적입니다. 변수명이나 설정 키에 공백을 넣을 수 없는 코드의 특성상, 하나의 고유 명사처럼 결합된 것입니다. Jekyll 공식 문서에서도 "front matter"와 "YAML front matter"를 혼용하지만, 커뮤니티에서는 대부분 붙여 씁니다.

---

정리: 명찰에서 메타데이터로

결국 프런트매터의 핵심은 시대를 관통하는 하나의 아이디어입니다.

"본론에 들어가기 전에, 이 콘텐츠가 무엇인지 알려주는 명찰을 달자."

500년 전 인쇄업자들이 책의 앞부분에 저자와 출판 정보를 배치한 것이나, 오늘날 개발자들이 Markdown 파일 상단에 YAML로 메타데이터를 적는 것이나, 근본적으로 같은 문제를 같은 방식으로 해결하고 있는 셈입니다.

출판의 "앞부속"이 디지털 시대의 "메타데이터"와 만나 프런트매터라는 이름으로 계속 살아 있다는 사실 — 개발 용어의 어원을 추적하는 재미가 바로 여기에 있습니다.