paper-to-slides

Cursor 스킬 — PPTX 양식 + 논문 PDF → 편집 가능한 슬라이드.

template.pptx  +  paper.pdf  →  Cursor 채팅  →  deck-editable.pptx

한글·영어 논문 모두 지원.

• 개요
• 설치
• 빠른 시작 (3단계)
• 사용 메뉴얼
  • 1. PPT 양식 등록
  • 2. Cursor에서 변환
  • 3. 결과물
  • 4. 직접 빌드 (터미널)
  • 5. 수정하기
  • 6. 이미지와 표
  • 7. 인용 (in-text citation)
• 내장 템플릿
• 커스텀 템플릿 만들기
• 출력 형식 비교
• 샘플 테스트
• 프로젝트 구조
• 추가 문서
• Cursor 마켓플레이스
• 자주 묻는 질문

Python 앱이 아닙니다. Cursor 에이전트가 논문을 읽고, 템플릿 규칙에 맞춰 슬라이드를 만듭니다.

git clone https://github.com/dschloe/paper2ppt.git
cp -r paper2ppt ~/.cursor/skills/paper-to-slides
cd ~/.cursor/skills/paper-to-slides && npm install

HTML 미리보기가 필요하면 (선택):

npm install -g @marp-team/marp-cli

Cursor를 재시작하거나 새 채팅을 열면 스킬이 자동으로 인식됩니다.

node scripts/import_pptx_template.mjs ~/my-template.pptx --name my-style

내장 템플릿만 쓸 거면 이 단계는 건너뛰고 academic을 쓰면 됩니다.

my-style 템플릿으로 이 논문 7장 슬라이드 만들어줘

PDF를 채팅에 첨부하거나, 파일 경로·arXiv 링크를 붙여넣으세요.

에이전트가 deck-editable.pptx를 만들어 줍니다. PowerPoint에서 바로 열어 편집할 수 있습니다.

회사·학교에서 쓰는 PPT 양식이 있으면 등록합니다.

node scripts/import_pptx_template.mjs ~/Downloads/my-format.pptx --name my-style

생성되는 폴더:

templates/my-style/
├── template.pptx   # 당신의 양식 (복사본)
├── pptx.json       # 색상·폰트 자동 추출
└── template.yaml   # 슬라이드 구성 (7장 기본)

이후 채팅에서 my-style 템플릿으로 ...라고 지정하면 됩니다.

프로젝트 기본 템플릿을 고정하려면 프로젝트 루트에 .paper2slides 파일을 만듭니다:

template: my-style

한글 예시

academic 템플릿으로 이 논문 슬라이드 만들어줘

이 PDF 논문을 7장 발표자료로 요약해줘. 결과는 samples/runs/my-paper/ 에 저장해줘

영어 예시

summarize this PDF as slides using the academic template

make a 7-slide deck from this arXiv paper: https://arxiv.org/abs/2412.xxxxx

에이전트가 자동으로:

1. 논문 PDF 읽기
2. deck.md 작성 (제목 → 문제 → 방법 → 결과 → 한계 → 결론)
3. deck-editable.pptx 렌더링

에이전트가 만든 deck.md를 직접 렌더링할 때:

# 편집 가능 PPTX (권장)
scripts/build_deck.sh path/to/deck.md path/to/output/deck \
  --template my-style --editable-pptx

# HTML만
scripts/build_deck.sh path/to/deck.md path/to/output/deck --template academic

# Marp 이미지 PPTX (편집 불가)
scripts/build_deck.sh path/to/deck.md path/to/output/deck --template academic --pptx

결과: output/deck-editable.pptx, output/deck.html

내용을 크게 바꾼 뒤에는 deck.md 수정 → --editable-pptx 재실행이 가장 깔끔합니다.

논문의 표·그림을 슬라이드에 넣을 수 있습니다.

표 — deck.md에 마크다운 테이블 작성 (결과 비교 슬라이드에 권장):

# Key Results

| Method | Accuracy |
|---|---|
| Baseline | 71.2% |
| **Ours** | **78.9%** |

이미지 — PDF에서 그림 추출 후 슬라이드에 삽입:

# poppler 필요: brew install poppler
scripts/extract_pdf_figures.sh paper.pdf samples/runs/my-run/assets/

deck.md 예시:

<!-- layout: figure -->
# 방법론 개요

![Figure 2](assets/fig-002.png)

*출처: 논문 Figure 2*

표 + 이미지 나란히:

<!-- layout: image-table -->
# 실험 결과

| Method | Score |
|---|---|
| Ours | 78.9% |

![width:380px](assets/fig-chart.png)

Cursor 채팅: "논문 Figure 2랑 Table 3 넣어서 슬라이드 만들어줘"

자세한 문법: references/marp-syntax.md

이론·선행연구·통계를 인용할 때 슬라이드 불릿 끝에 (저자, 연도) 형식을 붙입니다.

- **RAG**로 환각 감소 (Patrick Lewis et al., 2021)
- Spence (1973)은 학력을 노동시장 신호로 본다
- 2023년 졸업자 취업률 70.3% (교육부, 2023)

• 발표 논문 저자는 풀네임 — Afzal et al. 대신 Anum Afzal, Alexander Kowsik, Rajna Fani, & Florian Matthes
• 논문 본인 그림·표: *출처: Anum Afzal, Alexander Kowsik, Rajna Fani, & Florian Matthes (2024), Figure 2*
• 마지막 슬라이드에 주요 참고문헌 5~8개 요약 가능
• Cursor 채팅: "in-text citation 추가해줘"

별도 양식 없이 바로 사용:

academic 템플릿으로 이 논문 슬라이드 만들어줘

# 1) 예시 폴더 복사
cp -r templates/_example templates/my-style

# 2) my-style/template.pptx 를 본인 양식으로 교체

# 3) import (색/폰트 추출 + template.yaml 생성)
node scripts/import_pptx_template.mjs templates/my-style/template.pptx --name my-style

# 4) 필요하면 template.yaml 에서 슬라이드 제목·개수 조정

자세한 템플릿 스펙: references/template-system.md

repo에 포함된 샘플 논문으로 테스트:

# 영어 논문 샘플
scripts/build_deck.sh \
  samples/runs/academic-afzal-hr-rag/deck.md \
  samples/runs/academic-afzal-hr-rag/output/deck \
  --template academic --editable-pptx

# 한글 논문 샘플
scripts/build_deck.sh \
  samples/runs/academic-jung-signaling/deck.md \
  samples/runs/academic-jung-signaling/output/deck \
  --template academic --editable-pptx

샘플 구조:

samples/
├── papers/              # 테스트용 PDF (git 제외)
└── runs/<name>/
    ├── source.md        # 사용한 논문 정보
    ├── deck.md          # 슬라이드 원본
    └── output/
        └── deck-editable.pptx

자세한 내용: samples/README.md

paper-to-slides/
├── SKILL.md                    # Cursor 에이전트 워크플로
├── README.md                   # 이 문서 (사용 메뉴얼)
├── MARKETPLACE.md              # 마켓플레이스 제출 가이드
├── .cursor-plugin/             # Cursor 마켓플레이스 매니페스트
├── assets/logo.svg             # 마켓플레이스 아이콘
├── templates/
│   ├── academic/               # 기본 템플릿
│   ├── seminar/
│   ├── _example/               # 커스텀 템플릿 시작점
│   └── <your-name>/            # import로 생성
│       ├── template.pptx
│       ├── pptx.json
│       └── template.yaml
├── scripts/
│   ├── import_pptx_template.mjs
│   ├── build_editable_pptx.mjs
│   └── build_deck.sh
├── references/
│   ├── quickstart.md           # README 요약본
│   ├── template-system.md
│   └── marp-syntax.md
└── samples/                    # 테스트 예시

1. 이 저장소를 GitHub에 push (https://github.com/dschloe/paper2ppt)
2. cursor.com/marketplace/publish 에서 repo URL 제출
3. 심사 통과 후 Customize → Marketplace 에서 설치

로컬 테스트·체크리스트: MARKETPLACE.md

Q. Python 설치가 필요한가요?
아니요. Node.js만 있으면 됩니다 (npm install).

Q. 논문이 한글인데 슬라이드는 영어로 만들 수 있나요?
네. 채팅에서 *"영어로 슬라이드 만들어줘"*라고 요청하면 됩니다.

Q. PPTX에서 글자를 직접 고칠 수 있나요?
deck-editable.pptx는 가능합니다. deck.pptx(Marp)는 이미지라 편집이 어렵습니다.

Q. 내 회사 PPT 양식 그대로 쓸 수 있나요?
부분적으로 가능합니다. PowerPoint 파일을 그대로 “슬라이드 복사”하는 방식은 아��고, 양식에서 색·폰트를 읽어 새 슬라이드를 같은 톤으로 만듭니다.

1. 등록 — 회사 .pptx를 import합니다.

   node scripts/import_pptx_template.mjs ~/company-template.pptx --name company

2. 자동 추출��는 것 — PPT 테마에서 글꼴, 제목/본문 색, 강조색, 표 헤더 색 등이 templates/company/pptx.json에 저장됩니다. 원본 파일은 templates/company/template.pptx에 보관됩니다.
3. 생성되는 것 — 논문 내용은 template.yaml의 슬라이드 구조(제목·불릿·표 등)에 맞춰 deck-editable.pptx로 출력됩니다. 텍스트 박스는 편집 가능합니다.
4. 그대로 안 되는 것 — 회사 로고 위치, 슬라이드 마스터 모양, 도형·배경 이미지, 정확한 여백/박스 배치는 자동 복제되지 않습니다. (향후 template.pptx 슬라이드를 직접 채우는 방식으로 확장 예정)
5. 미세 조정 — 색이 어긋나면 templates/company/pptx.json을 직접 수정하거나, 양식 pptx를 고친 뒤 import를 다시 실행하세요.

정리: 브랜드 색·폰트는 반영, 레이아웃은 스킬 기본 구조 + 편집 가능 PPTX입니다. 픽셀 단위 동일 양식이 필요하면 생성 후 PowerPoint에서 로고·마스터를 수동으로 맞추는 것이 가장 빠릅니다.

Q. arXiv 링크만 주면 되나요?
네. 채팅에 링크를 붙이고 변환을 요청하면 됩니다.

Q. 슬라이드 장수를 바꾸고 싶어요.
"10장으로 만들어줘" 또는 template.yaml의 chapters를 수정하세요.