slide-authoring

Slide Authoring — Marp Markdown

slide는 Marp Markdown으로 작성한 뒤 marp CLI로 HTML 렌더한다. AI가 raw HTML을 직접 쓰면 레이아웃이 깨지기 쉬우므로 반드시 Marp MD 경유.

Marp 프론트매터 표준

---
marp: true
theme: default
paginate: true
footer: "LO-X.Y"
style: |
  section { font-size: 28px; }
  h1 { font-size: 42px; }
  code { font-size: 22px; }
---

• paginate: true — 우하단 페이지 번호
• footer는 class의 주 LO id. 슬라이드마다 다른 LO면 슬라이드 안에 <!-- _footer: "LO-X.Z" --> 오버라이드

슬라이드 개수

• class당 4~7장 고정
• 공식: beats 개수 + 1 (제목 슬라이드) + (마무리/recap 1)

슬라이드 레이아웃 규칙 (택1)

각 슬라이드는 다음 3가지 중 정확히 하나만 담는다:

A. Bullet 슬라이드 (3~5 bullet)

## 서버 컴포넌트란

- 서버에서 렌더링되는 React 컴포넌트
- 클라이언트 번들에 포함되지 않음
- DB/파일시스템 직접 접근 가능
- Suspense 경계로 스트리밍됨

B. Code 슬라이드 (≤15줄)

## RSC 예시

~~~jsx
// app/posts/page.js
export default async function Page() {
  const posts = await db.query(...);
  return posts.map(p => <Post {...p} />);
}
~~~

C. Diagram 슬라이드 (그림/다이어그램)

Mermaid 내장 가능 (default theme 지원):

## 요청 흐름

~~~mermaid
flowchart LR
  Browser --> Edge --> Server --> DB
~~~

제목 규칙

• h2 (##) 사용, h1은 제목 슬라이드에만
• ≤10 단어, 조사 제외
• 질문형/선언형 섞어서 리듬감 (무엇이 RSC인가 → RSC는 어디에 쓰는가 → RSC 예시)

Overflow 방지

• 텍스트 총량 ≤80 단어/슬라이드 (ko 기준 160자)
• 코드 ≤15줄, 초과 시 분할 + (이어서) 서브타이틀
• 이미지 문법 정확히 준수할 것 — Marp 는 alt + dimension 을 space-separated로만 인식한다:
  • ![alt text](url) — alt 만
  • ![w:600](url) — dimension 만 (w:NUMBER, h:NUMBER — px 단위 없이 숫자만)
  • ![alt text w:600](url) — alt + dimension (dimension 은 항상 마지막, space-separated)
  • 금지: ![w:600 alt:"..."](url) — alt: prefix 는 Marp가 인식 못해 통째로 plain text 로 렌더됨 (과거 실전 사고)
  • 금지: ![width:600px ...](url) — width: 가 아니라 w:, 단위는 생략
• data: URI 사용 금지 — Marp 는 보안 정책상 data:image/... URL 을 모든 형식(utf8,·base64,)에서 통째로 거부한다 (verified with marp-cli v4.3.1: ![x](data:image/svg+xml;base64,...) → <img> 태그 생성 안 됨, 원본 markdown 이 <p> 로 래핑되어 슬라이드에 raw text 노출). 인라인 다이어그램이 필요하면 SVG/PNG 를 slides_png/diag-NN.svg 같은 실제 파일로 저장하고 상대경로로 참조할 것:

  ![다이어그램 설명 w:720](slides_png/diag-01.svg)
  

  Marp 는 --allow-local-files 플래그(build-bundle.sh 에 이미 포함)로 로컬 파일 SVG 를 PNG 렌더 시 인라인화한다.