Slidev 발표 노트 PDF가 비어 있어, 대기 옵션을 넣어 다시 뽑았습니다

AI로 만든 Slidev 발표자료에서 발표자 노트만 따로 뽑았는데, 파일은 생기고 내용은 비어 있었습니다. 같은 자료에 --wait 2000을 붙여 다시 내보내자 가상 메모가 들어 있는 PDF가 나왔습니다.

검증한 버전은 @slidev/cli 0.49.29입니다. 최신 패키지는 이 macOS 실행 환경에서 네이티브 모듈 보안 오류로 시작하지 못해, 별도 임시 폴더에 구버전을 설치했습니다. 아래 결과를 최신판 전체의 동작으로 일반화하면 안 됩니다.

기본 슬라이드 PDF와 노트 PDF도 서로 달랐습니다. 기본 PDF에는 슬라이드 본문만 있었고, 대기 옵션을 넣은 노트 PDF에는 발표자 메모가 담겼습니다. 모두 비민감 가상 문구로 시험했습니다.

슬라이드와 노트에 다른 표시를 넣었습니다

두 장짜리 slides.md의 첫 장 본문에 VISIBLE_MARKER_ONE, 마지막 HTML 주석에 FAKE_PRIVATE_NOTE_ONE을 적었습니다. 둘째 장에는 끝을 TWO로 바꾼 표시를 넣어 본문과 노트를 구분했습니다.

노트는 <!-- FAKE_PRIVATE_NOTE_ONE -->처럼 슬라이드의 마지막 주석 블록에 작성합니다. 실제 내부 메모 없이도 산출물에 무엇이 들어가는지 시험할 수 있습니다.

파일 생성과 내용 생성을 따로 확인했습니다

기본 export로 받은 pdf-default.pdf는 2페이지였습니다. 추출 텍스트에는 ONE과 TWO 본문 표시가 있었고, FAKE_PRIVATE_NOTE 표시는 없었습니다. 첫 페이지 이미지에서도 본문을 확인했습니다.

그다음 export-notes를 대기 옵션 없이 실행했습니다. pdf-notes-only.pdf는 1페이지, 758바이트였지만 추출된 글은 비어 있었습니다. 파일이 존재한다는 이유만으로 발표 대본이 준비됐다고 보고할 수 없는 결과입니다.

export-notes --wait 2000으로 받은 pdf-notes-wait.pdf에는 두 노트 표시가 모두 들어 있었습니다. 텍스트와 페이지 이미지를 대조했습니다. 이번 실행은 해결됐지만 모든 환경의 원인을 타이밍 문제라고 확정하지는 않습니다.

같은 버전에서 재현할 명령

Slidev 프로젝트와 Playwright용 Chromium을 준비한 분을 위한 명령입니다. 0.49.29에서 검증했으며, 최신 설치를 구버전으로 바꾸라는 권고는 아닙니다.

npx slidev export --output pdf-default

npx slidev export-notes --output pdf-notes-only

npx slidev export-notes --wait 2000 --output pdf-notes-wait

노트가 비면 마지막 주석 블록에 문구가 있는지 확인하고, 별도 파일명으로 다시 내보내세요. 2000은 이번에 성공한 대기값이며 복잡한 자료에도 충분하다고 보장하지 않습니다.

공유할 파일은 마지막에 다시 고르세요

발표자 메모를 전달하려면 노트 PDF의 내용을 열어 확인하고 보내세요. 청중용 파일에는 메모가 없어야 한다면, 최종 파일에서 가상 표시나 내부 문구를 찾아보고 실제 페이지도 확인해야 합니다. 기본 PDF에서 빠졌다는 이번 결과만으로 다른 형식까지 안전하다고 보면 안 됩니다.

현재 공식 문서는 PPTX에 발표자 노트가 슬라이드별로 전달된다고 안내합니다. PPTX 출력 자체는 이번에 시험하지 않았습니다. 노트 전용 export-notes 설명은 공식 레거시 문서에서 확인했으므로, 다른 버전에서는 CLI 도움말과 실제 출력으로 지원 여부를 확인하세요.

최신판 실행, 노트가 없는 슬라이드, 복잡한 테마, 모든 파일 메타데이터는 검증 범위 밖입니다. 비밀정보가 전혀 없음을 인증하는 검사가 아니라, 가상 표시의 포함 여부와 빈 출력 문제를 확인한 작은 실험입니다.

출처: Slidev 공식 레거시 내보내기 문서의 Presenter notes 항목

https://docs-legacy.sli.dev/guide/exporting

Slidev

현재 형식별 내보내기 안내

https://sli.dev/guide/exporting

Slidev

커버는 설명용 AI 이미지이며 실제 제품 화면이 아닙니다.