구조화된 메타데이터 — 모든 내보내기가 지식 자산입니다
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와 같은 도구에서 읽을 수 있어 지식 베이스에 대한 강력한 쿼리가 가능합니다.
실제 워크플로에서 활용하는 방법이 궁금하다면 AI 대화를 Obsidian으로 내보내기 가이드나 ChatGPT 기록 전체를 Obsidian에 동기화하는 가이드를 확인하세요.
사용 가능한 필드
모든 필드는 설정 → 일반 → 프론트매터에서 개별적으로 토글할 수 있습니다:
기본 정보:
| 필드 | 설명 | 기본값 |
|---|---|---|
| 제목 | 자동 생성된 대화 제목 | 켜짐 |
| 대화 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 데이터베이스 속성에 기록 | 켜짐 |
내보내기 유형별 출력 형식
메타데이터 형식은 내보내기 대상에 따라 자동으로 결정되며, 수동 형식 선택기는 없습니다:
| 내보내기 형식 | 메타데이터 구문 | 참고 |
|---|---|---|
| Markdown (.md) | YAML Frontmatter ---\nkey: value\n--- | 산업 표준, Obsidian / Hugo / Jekyll 호환 |
| Notion | 인라인 **레이블:** 값 | Notion은 YAML frontmatter를 지원하지 않습니다 |
| 일반 텍스트 (.txt) | 일반 텍스트 레이블: 값 | 특수 구문 없이 읽기 쉬운 텍스트 |
| PDF / Word | 시각적 HTML 정보 블록 | 문서 헤더에 서식 있는 메타데이터 테이블로 렌더링 |
Frontmatter 설정의 OUTPUT FORMATS 토글로 각 내보내기 형식(Markdown, TXT, PDF, Word, JSON, Notion, Clipboard)별로 메타데이터를 포함할지 독립적으로 제어할 수 있습니다.
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 렌더러는 기본적으로 프론트매터를 숨깁니다. 이것은 메타데이터이지 보이는 콘텐츠가 아닙니다.