{"slug":"bam-bam-2-book-pdf","name":"book-pdf","description":"마크다운 원고를 진짜 책처럼 보이는 PDF·EPUB 전자책으로 만든다. 표지, 판권 페이지, 실제 쪽번호가 달린 목차, 장별 러닝헤더까지 갖춘다. Paged.js 사용.","long_description":"---\nname: book-pdf\ndescription: \"마크다운 원고를 진짜 책처럼 보이는 PDF·EPUB 전자책으로 만든다. 표지, 판권 페이지, 실제 쪽번호가 달린 목차, 장별 러닝헤더까지 갖춘다. Paged.js 사용.\"\n---\n\n# 마크다운 → 진짜 책 PDF/EPUB\n\n일반 `page.pdf()` + 마크다운→HTML 변환만으로는 \"리포트를 인쇄한 것\"처럼 보인다.\n실제 책이려면 최소 이 6가지가 있어야 한다: **표지(풀블리드) · 타이틀 페이지 · 판권 페이지 · 실제 쪽번호가 달린 목차 · 장 시작마다 새 페이지 · 쪽마다 러닝헤더/쪽번호**.\n\n이 스킬은 [Paged.js](https://pagedjs.org)(MIT, `https://unpkg.com/pagedjs/dist/paged.polyfill.js`)를 브라우저에 스크립트 태그로 로드해 CSS Paged Media 기능(러닝헤더, 목차 쪽번호 자동생성)을 구현한다. Chromium이 네이티브로 지원 안 하는 기능이라 이 폴리필이 필요하다.\n\n## 바로 쓰는 스크립트\n\n[`scripts/html-to-pdf.py`](scripts/html-to-pdf.py) — Paged.js로 조판한 HTML을 PDF로 굽습니다.\n\n```bash\npip install playwright && playwright install chromium\npython scripts/html-to-pdf.py book.html\npython scripts/html-to-pdf.py \"chapters/*.html\" # 여러 개 한 번에\n```\n\n`--output`으로 경로를 지정할 수 있고, 생략하면 입력 파일명 그대로 `.pdf`가 나옵니다.\n\n## 이 환경(Aside REPL)의 알려진 함정\n\n1. **`page.pdf({width, height})` 파라미터가 무시된다.** 항상 US Letter로 나온다. 반드시 `preferCSSPageSize: true`를 주고 CSS `@page { size: 148mm 210mm; }`로 크기를 지정할 것. `format: 'A5'` 같은 심볼릭 사이즈도 마찬가지로 무시되니 쓰지 말 것.\n2. **`page.setViewportSize()`가 없다.** 뷰포트 크기를 못 바꾸므로 표지 등 개별 이미지를 만들 때 `page.screenshot({fullPage:true})`로 큰 캔버스를 찍으면 타일링 버그가 난다. 대신 `page.pdf()` + `pdftoppm`으로 원하는 크기를 렌더링할 것.\n3. **`page.addScriptTag()`가 없다.** 외부 스크립트(Paged.js 등)는 `document.write()`로 쓰는 HTML 문자열 안에 `\n ${frontMatter}${bodyContent}