Demo Deck

GitHub로 발표자료 공유

HTML 슬라이드는 링크로 바로 넘겨 보고, PDF는 다운로드용 백업으로 둔다.

Why HTML

PDF보다 발표 화면에 가깝다

1 링크 하나 받는 사람이 파일을 내려받지 않아도 바로 본다.
2 페이지 이동 좌우 이동, 진행률, 모바일 화면까지 자연스럽다.
3 버전 관리 수정 이력이 GitHub commit으로 남는다.
4 PDF 백업 메일 첨부나 내부 공유용 파일도 같이 둘 수 있다.

Repository Shape

공유용 구조는 작게 유지

GitHub Pages는 `docs/`만 배포하고, `exports/`는 다운로드 파일을 보관한다.

presentations/
  README.md
  docs/
    index.html
    assets/
  exports/
    slides.pdf

Workflow

Claude Code식 흐름

Markdown이나 HTML로 초안을 만들고, 브라우저에서 확인한 다음 GitHub에 올린다.

초안 생성 주제, 목차, 메시지를 먼저 잡고 슬라이드 단위로 쪼갠다.
HTML 확인 실제 브라우저에서 글자 넘침, 화면 비율, 이동 동작을 본다.
GitHub 공유 `docs/index.html`은 Pages로, `exports/*.pdf`는 백업 링크로 공유한다.

Pick The Format

상황별 선택

Fast PDF만 올리기 최소 작업. README 링크만 있으면 바로 공유 가능.
Best Demo HTML + PDF 웹 발표 링크와 다운로드 파일을 둘 다 제공.
Reusable 템플릿화 반복 발표가 많으면 이 구조를 그대로 복사해서 재사용.

Result

공유 링크는 하나로 끝낸다

외부에는 GitHub Pages URL을 주고, 파일이 필요한 사람에게만 PDF 링크를 함께 준다.

웹 발표 보기
https://your-id.github.io/presentations/

PDF 다운로드
https://github.com/your-id/presentations/blob/main/exports/slides.pdf