마크다운 문서를 더 근사하게 — frontmatter 가이드

onepage · 2026. 7. 12. · 1분 읽기

onepage에 마크다운을 붙여넣으면 그대로 발행됩니다. 아무것도 더 쓸 필요 없어요 — 제목은 첫 헤딩에서, 날짜는 발행일에서, 읽기 시간은 본문에서 자동으로 만들어집니다.

그런데 문서 맨 앞에 몇 줄을 더하면 조금 더 근사해집니다. 지금 이 문서 상단에 보이는 제목·저자·날짜가 바로 그 결과입니다.

쓰는 법

문서의 첫 줄이 ---로 시작하면 됩니다. 이 블록은 화면에 보이지 않고, 문서의 정보로만 쓰입니다.

---
title: 주간 리포트 7월 2주
description: 이번 주 완료 항목과 다음 주 계획
author: 김온페
date: 2026-07-12
tags: [리포트, 주간]
---

# 주간 리포트 7월 2주

본문은 여기서부터...

전부 선택입니다. 쓴 것만 반영되고, 모르는 필드는 조용히 무시됩니다.

필드	역할
`title`	문서 제목 — 상단 헤더, 브라우저 탭, 공유 카드 제목
`description`	공유 카드(카톡·슬랙 등)에 뜨는 요약 한 줄
`author`	저자 표시 이름. 안 쓰면 표시되지 않습니다 (익명 발행 존중)
`date`	표시 날짜. 안 쓰면 발행일이 자동으로. `date: false`로 아예 숨길 수 있어요
`image`	공유 카드 이미지 URL (https만)
`tags`	`[a, b]` 형식. 지금은 저장만 되고, 곧 컬렉션 기능에서 쓰입니다

문서를 AI로 만들고 있다면 프롬프트에 한 줄만 더하세요:

"맨 앞에 YAML frontmatter(title, description, author, date)를 붙여줘"

대부분의 AI가 이 형식을 이미 알고 있어서, 그대로 붙여넣으면 끝입니다. API로 발행하는 에이전트라면 API 문서를 참고하세요 — title을 따로 보내지 않아도 frontmatter에서 알아서 읽습니다.

HTML은 여러분이 페이지의 전부를 디자인하는 형식이라, onepage가 헤더를 얹지 않습니다. frontmatter도 필요 없어요 — 제목은 <title> 태그에서 자동으로 가져갑니다.