구조화된 메타데이터 — 모든 내보내기가 지식 자산입니다
YAML 프론트매터는 Markdown 내보내기를 단순한 텍스트 파일에서 구조화된 쿼리 가능한 지식 자산으로 변환합니다. 각 파일은 Obsidian, Notion 및 기타 PKM 도구에서 검색할 수 있게 만드는 풍부한 메타데이터를 담고 있습니다.
YAML 프론트매터란?
YAML 프론트매터는 Markdown 파일 상단의 구조화된 메타데이터 블록으로, --- 마커로 둘러싸여 있습니다:
---
title: "Building a REST API with FastAPI"
tags: [python, fastapi, rest-api, backend]
summary: "Step-by-step guide to creating a RESTful API using FastAPI, including authentication and database integration."
model: claude-3.5-sonnet
platform: claude
date: 2024-01-15
word_count: 3420
---이 메타데이터는 렌더링된 Markdown에서는 보이지 않지만 Obsidian Dataview와 같은 도구에서 읽을 수 있어 지식 베이스에 대한 강력한 쿼리가 가능합니다.

사용 가능한 필드
모든 필드는 설정 → 일반 → 프론트매터에서 개별적으로 토글할 수 있습니다:
기본 정보:
| 필드 | 설명 | 기본값 |
|---|---|---|
| 제목 | 자동 생성된 대화 제목 | 켜짐 |
| 대화 ID | 대화의 고유 식별자 | 켜짐 |
| 플랫폼 | AI 플랫폼 이름 (chatgpt, claude 등) | 켜짐 |
| 모델 이름 | 사용된 AI 모델 (gpt-4, claude-sonnet-4 등) | 켜짐 |
| 소스 URL | 원래 대화로의 링크 | 켜짐 |
시간 정보:
| 필드 | 설명 | 기본값 |
|---|---|---|
| 생성 시간 | 대화가 시작된 시간 | 켜짐 |
| 업데이트 시간 | 대화가 마지막으로 업데이트된 시간 | 켜짐 |
| 내보내기 시간 | 내보내기가 수행된 시간 | 켜짐 |
통계:
| 필드 | 설명 | 기본값 |
|---|---|---|
| 메시지 수 | 대화의 메시지 수 | 켜짐 |
| 단어 수 | 총 단어 수 | 켜짐 |
| 콘텐츠 유형 | 콘텐츠 유형 (code, images, tables, citations) | 켜짐 |
AI 강화:
| 필드 | 설명 | 기본값 |
|---|---|---|
| AI 태그 | AI 생성 주제 태그 | 꺼짐 |
| AI 요약 | AI 생성 대화 요약 | 꺼짐 |
형식:
| 필드 | 설명 | 기본값 |
|---|---|---|
| 날짜 형식 | ISO 8601 / 날짜만 / 로컬 | ISO 8601 |
| 네이티브 속성 삽입 | PDF 문서 속성 / Notion 데이터베이스 속성에 기록 | 켜짐 |



내보내기 유형별 출력 형식
프론트매터 메타데이터는 metaOutputFormat 설정으로 제어되는 3가지 형식으로 출력할 수 있습니다:
| 출력 형식 | 구문 | 사용처 |
|---|---|---|
| YAML 프론트매터 | ---\nkey: value\n--- | Markdown (.md) |
| 인라인 메타데이터 | **라벨:** 값 | Notion, TXT/MD |
| 일반 텍스트 | 라벨: 값 | TXT |
각 내보내기 형식 (Markdown, TXT, PDF, Word, JSON, Notion, 클립보드)은 프론트매터 섹션의 출력 형식 토글을 통해 메타데이터를 독립적으로 켜거나 끌 수 있습니다.

YAML 프론트매터 활성화
YAML 프론트매터는 AI 태그 & 요약이 활성화될 때 생성됩니다:
- 설정 → 일반 → 🔗 AI 제공자로 이동합니다
- 제공자를 선택하고 API 키를 입력합니다
- AI 태그 & 요약을 활성화합니다
- Markdown으로 내보내기 — 프론트매터가 자동으로 포함됩니다
AI 태그가 활성화되지 않아도 내보내기에는 최소한의 프론트매터 블록에 기본 메타데이터(날짜, 플랫폼, 모델)가 여전히 포함됩니다.
Frequently Asked Questions
개별 프론트매터 필드를 토글할 수 있나요?+
네. 모든 필드(제목, conversation_id, 플랫폼, 모델, 날짜, 단어 수, 태그, 요약 등)는 설정 → 일반 → 프론트매터에서 개별적으로 켜거나 끌 수 있습니다.
어떤 날짜 형식을 사용할 수 있나요?+
세 가지 형식: ISO 8601 (2024-01-15T10:00:00Z), 날짜만 (2024-01-15), 로컬 (2024/01/15 10:00).
프론트매터가 Markdown 렌더링에 영향을 주나요?+
아니요. 대부분의 Markdown 렌더러는 기본적으로 프론트매터를 숨깁니다. 이것은 메타데이터이지 보이는 콘텐츠가 아닙니다.