Documentation

구조화된 메타데이터 — 모든 내보내기가 지식 자산입니다

YAML 프론트매터는 Markdown 내보내기를 단순한 텍스트 파일에서 구조화된 쿼리 가능한 지식 자산으로 변환합니다. 각 파일은 Obsidian, Notion 및 기타 PKM 도구에서 검색할 수 있게 만드는 풍부한 메타데이터를 담고 있습니다.

YAML 프론트매터란?

YAML 프론트매터는 Markdown 파일 상단의 구조화된 메타데이터 블록으로, --- 마커로 둘러싸여 있습니다:

yaml
---
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와 같은 도구에서 읽을 수 있어 지식 베이스에 대한 강력한 쿼리가 가능합니다.

모든 필드가 포함된 완전한 YAML 프론트매터 예시
모든 필드가 포함된 완전한 YAML 프론트매터 예시

사용 가능한 필드

모든 필드는 설정 → 일반 → 프론트매터에서 개별적으로 토글할 수 있습니다:

기본 정보:

필드설명기본값
제목자동 생성된 대화 제목켜짐
대화 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 데이터베이스 속성에 기록켜짐
프론트매터 설정 — 토글 스위치가 있는 기본 정보 그룹
프론트매터 설정 — 토글 스위치가 있는 기본 정보 그룹
프론트매터 설정 — 시간 정보 그룹
프론트매터 설정 — 시간 정보 그룹
프론트매터 설정 — AI 강화 그룹 (기능)
프론트매터 설정 — AI 강화 그룹 (기능)

내보내기 유형별 출력 형식

프론트매터 메타데이터는 metaOutputFormat 설정으로 제어되는 3가지 형식으로 출력할 수 있습니다:

출력 형식구문사용처
YAML 프론트매터---\nkey: value\n---Markdown (.md)
인라인 메타데이터**라벨:** 값Notion, TXT/MD
일반 텍스트라벨: 값TXT

각 내보내기 형식 (Markdown, TXT, PDF, Word, JSON, Notion, 클립보드)은 프론트매터 섹션의 출력 형식 토글을 통해 메타데이터를 독립적으로 켜거나 끌 수 있습니다.

출력 형식 토글 — 내보내기 형식별 메타데이터 켜기/끄기
출력 형식 토글 — 내보내기 형식별 메타데이터 켜기/끄기

YAML 프론트매터 활성화

YAML 프론트매터는 AI 태그 & 요약이 활성화될 때 생성됩니다:

  1. 설정 → 일반 → 🔗 AI 제공자로 이동합니다
  2. 제공자를 선택하고 API 키를 입력합니다
  3. AI 태그 & 요약을 활성화합니다
  4. Markdown으로 내보내기 — 프론트매터가 자동으로 포함됩니다

AI 태그가 활성화되지 않아도 내보내기에는 최소한의 프론트매터 블록에 기본 메타데이터(날짜, 플랫폼, 모델)가 여전히 포함됩니다.

Frequently Asked Questions

개별 프론트매터 필드를 토글할 수 있나요?+

네. 모든 필드(제목, conversation_id, 플랫폼, 모델, 날짜, 단어 수, 태그, 요약 등)는 설정 → 일반 → 프론트매터에서 개별적으로 켜거나 끌 수 있습니다.

어떤 날짜 형식을 사용할 수 있나요?+

세 가지 형식: ISO 8601 (2024-01-15T10:00:00Z), 날짜만 (2024-01-15), 로컬 (2024/01/15 10:00).

프론트매터가 Markdown 렌더링에 영향을 주나요?+

아니요. 대부분의 Markdown 렌더러는 기본적으로 프론트매터를 숨깁니다. 이것은 메타데이터이지 보이는 콘텐츠가 아닙니다.

Related Articles