가이드 · 2026년 11월 2일

Markdown 머리말로 작성일과 소개문 넣기

Markdown 문법에는 작성일이나 대상 독자를 적는 자리가 없습니다. 파일 맨 앞에 머리말(front matter)을 쓰면 이런 정보를 문서 머리에 깔끔하게 넣을 수 있습니다.

머리말이란

머리말은 Markdown 파일 맨 앞에서 --- 두 줄 사이에 적는 문서 정보입니다. Jekyll이나 Hugo 같은 정적 사이트 생성기와 옵시디언에서도 널리 쓰는 형식이고, 안의 내용은 YAML 문법을 따릅니다. 본문으로 출력되지 않고 문서 정보로만 쓰입니다.

---
eyebrow: HANDS-ON TUTORIAL · 입문부터 실습까지
title: 파이썬 데이터 분석 따라하기
description: 표 데이터를 읽어 그래프로 그리기까지의 과정을 따라갑니다.
meta:
  대상: 파이썬 기초를 아는 입문자
  검증 환경: macOS · Python 3.11
  작성일: 2026-11-02
---

## 1. 시작하기

쓸 수 있는 항목

항목	들어가는 곳	같은 뜻으로 쓸 수 있는 이름
`eyebrow`	제목 위의 작은 문구	kicker, category, 상단문구, 분류
`title`	큰 제목, 브라우저 탭 제목	제목
`description`	제목 아래 소개문	subtitle, summary, lede, 소개, 설명, 부제
`meta`	소개문 아래 정보 줄	이름과 값을 자유롭게 적습니다
`author`, `date`, `updated`, `version`, `audience`, `tags`	정보 줄(작성자, 작성일, 수정일, 버전, 대상, 태그)	-
`lang`	문서 언어 표시(기본 ko)	-

이름이 한글인 항목은 meta 아래에 넣지 않아도 정보 줄에 나옵니다. layout이나 slug처럼 다른 도구에서 쓰는 영어 항목은 조용히 무시하므로, 블로그용으로 쓴 파일을 그대로 넣어도 괜찮습니다.

머리말이 없으면

머리말은 선택 사항입니다. 없으면 맨 앞의 # 제목이 큰 제목이 되고, 바로 뒤에 이어지는 400자 이하의 문단이 소개문이 됩니다. # 제목이 없으면 파일 이름이 큰 제목이 됩니다. 머리말의 title과 맨 앞의 # 제목이 같으면 제목이 두 번 나오지 않게 하나만 씁니다. 다르면 # 제목은 본문의 장 제목으로 남습니다.

자주 하는 실수

콜론이 들어간 값

YAML에서 콜론과 공백은 이름과 값을 나누는 표시입니다. 값 안에 콜론이 있으면 따옴표로 감싸세요.

title: "1부: 데이터 읽기"

맨 앞에 빈 줄이 있는 경우

첫 줄이 ---로 시작해야 머리말로 인식합니다. 그 앞에 빈 줄이나 다른 글이 있으면 본문으로 처리됩니다.

들여쓰기

meta 아래 항목은 같은 칸만큼 들여 씁니다. 탭은 쓸 수 없고 공백 두 칸이면 충분합니다. 형식이 틀리면 변환 화면의 확인할 점에 이유가 나오고, 머리말은 본문으로 처리됩니다.

틀부터 넣고 고치기

변환 화면의 머리말 넣기를 누르면 문서 맨 앞에 틀이 들어갑니다. 제목은 문서의 # 제목에서, 작성일은 오늘 날짜에서 가져옵니다. 나머지 값을 고치고, 필요 없는 줄은 지우면 됩니다.

Markdown 변환하러 가기