본문으로 건너뛰기

Frontmatter

Frontmatter는 프레젠테이션의 전역 설정을 정의하는 YAML 블록입니다. 파일 최상단에 ---로 감싸서 작성합니다.

글로벌 Frontmatter​

단일 파일 프레젠테이션에서는 파일 최상단에, 멀티파일 프로젝트에서는 _presentation.md 파일에 작성합니다.

파일 확장자

.md 확장자를 사용하고 frontmatter에 remarp: true를 추가합니다. .remarp.md 확장자도 하위호환 지원됩니다.

---
remarp: true
version: 1
title: "AWS Architecture Deep Dive"
speaker:
  name: "김클라우드"
  title: "Solutions Architect"
  company: "AWS"
audience: "클라우드 엔지니어"
level: "300"
quiz: true
duration: 100
date: 2025-01-15
event: "AWS Summit 2025"
lang: ko

blocks:
  - name: fundamentals
    title: "Block 1: Fundamentals"
    duration: 30
  - name: advanced
    title: "Block 2: Advanced Patterns"
    duration: 25
  - name: hands-on
    title: "Block 3: Hands-On Lab"
    duration: 45

theme:
  primary: "#232F3E"
  accent: "#FF9900"
  font: "Amazon Ember"
  codeTheme: "github-dark"

transition:
  default: slide
  duration: 400

keys:
  next: ["ArrowRight", "Space", "n"]
  prev: ["ArrowLeft", "Backspace", "p"]
  overview: ["o", "Escape"]
  presenter: ["s"]
---

필드 레퍼런스​

기본 필드​

필드타입필수설명
remarpbooleanYestrue로 설정하여 Remarp 처리 활성화
versionnumberNo포맷 버전 (기본값: 1)
titlestringYes프레젠테이션 제목 (HTML <title>에 사용)
speakerobjectYes발표자 정보 (name, title, company 필드)
audiencestringYes대상 청중 (예: "클라우드 엔지니어", "개발자")
levelstringYes기술 수준 (100/200/300/400 또는 입문/중급/고급/전문가)
quizbooleanYes블록 끝 복습 퀴즈 포함 여부
durationnumberYes전체 발표 시간 (분 단위, blocks duration 합산과 일치)
datedateNo프레젠테이션 날짜 (YYYY-MM-DD)
eventstringNo이벤트 또는 컨퍼런스 이름
langstringNo언어 코드 (ko, en, ja)
author 필드 (deprecated)

author string 필드는 deprecated되었습니다. 대신 speaker 객체를 사용하세요. speaker.name이 없을 경우 author가 fallback으로 사용됩니다.

speaker 객체​

발표자 정보를 구조화된 형식으로 지정합니다:

speaker:
  name: "홍길동"
  title: "Sr. Solutions Architect"
  company: "AWS"
필드타입설명
namestring발표자 이름
titlestring직함
companystring소속 회사/조직

blocks 배열​

멀티파일 프로젝트에서 블록(섹션)을 정의합니다:

blocks:
  - name: architecture     # URL-safe 슬러그 (파일명에 사용)
    title: "Architecture"  # 사람이 읽는 제목
    duration: 30           # 소요 시간 (분)
필드타입설명
namestringURL-safe 식별자 (파일명 매칭용)
titlestring블록 제목
durationnumber예상 소요 시간 (분)

theme 객체​

테마 설정을 정의합니다:

theme:
  source: "./company-template.pptx"  # PPTX/PDF 파일 또는 추출된 디렉토리
  primary: "#232F3E"       # 기본 색상 (헤더, 배경)
  accent: "#FF9900"        # 강조 색상 (하이라이트, 링크)
  font: "Amazon Ember"     # 본문 폰트
  codeTheme: "github-dark" # 코드 구문 강조 테마
  footer: auto             # 자동 추출 또는 직접 지정
  pagination: true         # 페이지 번호 표시
  logo: auto               # 자동 추출 또는 경로 지정
필드타입설명
sourcestringPPTX/PDF 파일 경로 또는 추출된 테마 디렉토리
primarystring기본 색상 (CSS 색상값)
accentstring강조 색상 (CSS 색상값)
fontstring본문 폰트 패밀리
codeThemestring코드 구문 강조 테마
footerstringauto 또는 직접 문자열 지정
paginationboolean페이지 번호 표시 여부
logostringauto 또는 로고 파일 경로

transition 객체​

슬라이드 전환 효과를 정의합니다:

transition:
  default: slide           # 기본 전환 타입
  duration: 400            # 전환 시간 (ms)

사용 가능한 전환 타입: none, fade, slide, convex, concave, zoom

keys 객체​

키보드 단축키를 커스터마이즈합니다:

keys:
  next: ["ArrowRight", "Space", "n"]
  prev: ["ArrowLeft", "Backspace", "p"]
  overview: ["o", "Escape"]
  presenter: ["s"]

블록 파일 Frontmatter​

멀티파일 프로젝트에서 각 블록 파일(01-fundamentals.md 등)은 로컬 frontmatter를 가집니다:

---
remarp: true
block: fundamentals
title: "Block 1: Fundamentals"
---

로컬 Frontmatter 필드​

필드타입필수설명
remarpbooleanYesRemarp 파일 식별자
blockstringYes블록 이름 (글로벌 blocks[].name과 매칭)
titlestringNo블록 제목 (글로벌 설정 오버라이드)

PPTX 테마 소스​

PPTX 파일을 테마 소스로 지정하면 색상, 폰트, 로고가 자동으로 추출됩니다:

theme:
  source: "./company-template.pptx"
  footer: auto
  logo: auto
소스 타입예시동작
PPTX 파일./template.pptx_theme/ 디렉토리로 테마 추출
PDF 파일./template.pdf색상과 이미지 추출
디렉토리./_theme/template/이미 추출된 테마 사용

예제: 완전한 글로벌 Frontmatter​

---
remarp: true
version: 1
title: "AWS Serverless Architecture"
speaker:
  name: "홍길동"
  title: "Sr. Solutions Architect"
  company: "AWS"
audience: "서버리스 개발자"
level: "300"
quiz: true
duration: 90
date: 2025-03-01
event: "AWS Tech Talk"
lang: ko

blocks:
  - name: fundamentals
    title: "Block 1: Serverless Fundamentals"
    duration: 25
  - name: patterns
    title: "Block 2: Architecture Patterns"
    duration: 30
  - name: hands-on
    title: "Block 3: Hands-On Lab"
    duration: 35

theme:
  source: "./aws-template.pptx"
  footer: "© 2025, Amazon Web Services"
  pagination: true
  logo: auto

transition:
  default: slide
  duration: 400

keys:
  next: ["ArrowRight", "Space"]
  prev: ["ArrowLeft"]
  presenter: ["p"]
---