Ipynb PDF Converter
VSCode 익스텐션으로 Jupyter Notebook (.ipynb) 및 Markdown (.md) 파일을 PDF 문서로 변환합니다.
아이티윌에서 진행되는 이광호 강사의 수업에서 활용될 목적으로 개발되었습니다.
기능
- 파일 탐색기 / 에디터 탭 / 명령 팔레트에서 .ipynb·.md 파일을 PDF로 변환 (
Convert Notebook/Markdown to PDF)
- 페이지 단위로 분할되어 일반 PDF 뷰어에서 페이지 넘기기 가능 (Galaxy Tab S9 세로 모드 기본 최적화: 800 × 1280 CSS px)
- PDF 페이지 여백 설정(
pdfPageMargin, 기본 32 px)으로 콘텐츠를 페이지 안쪽에 여유 있게 배치
- 코드 셀 신택스 하이라이트 테마 9종 (Dracula, GitHub Light/Dark, Atom One Light/Dark, Monokai, Nord, VS Dark, Leekh)
Leekh는 A4 인쇄 스타일로 제목·표·출력까지 함께 꾸며줍니다
- 외부 런타임 의존성 없음 — Python, nbconvert, Playwright, 별도 Chromium 설치 불필요. VSCode 내장 Webview에서 직접 렌더링하고 캡처합니다.
사용 방법
- VSCode에서 .ipynb 또는 .md 파일을 마우스 우클릭
Convert Notebook/Markdown to PDF 선택- 같은 디렉토리에
.pdf 파일이 생성됨
환경설정
VSCode의 settings.json에서 다음과 같이 설정할 수 있습니다:
{
"ipynb-pdf-converter.pdfPageWidth": 800,
"ipynb-pdf-converter.pdfPageHeight": 1280,
"ipynb-pdf-converter.pdfPageMargin": 32,
"ipynb-pdf-converter.deviceScaleFactor": 3,
"ipynb-pdf-converter.codeTheme": "dracula"
}
- ipynb-pdf-converter.pdfPageWidth: PDF 페이지 가로 폭 (CSS px, 기본값:
800 — Galaxy Tab S9 portrait)
- ipynb-pdf-converter.pdfPageHeight: PDF 페이지 세로 폭 (CSS px, 기본값:
1280 — Galaxy Tab S9 portrait)
- PDF 콘텐츠가 (페이지 높이 − 여백)을 넘기면 자동으로 여러 페이지로 분할됨
- ipynb-pdf-converter.pdfPageMargin: PDF 페이지 내부 여백 (CSS px, 기본값:
32) — 모든 페이지의 상하좌우에 동일하게 적용
- ipynb-pdf-converter.deviceScaleFactor: 출력 배율 (1-5, 기본값: 3)
- ipynb-pdf-converter.codeTheme: 코드 셀 하이라이트 테마 (기본값:
dracula)
또는 VSCode 설정 UI에서 "Ipynb PDF Converter" 섹션을 찾아 직접 설정할 수 있습니다.
동작 원리
- .ipynb 파일은 JSON으로 파싱, .md 파일은 본문 전체를 마크다운으로 처리
- 마크다운은
marked, 코드 셀은 highlight.js로 HTML 생성
- VSCode Webview (내장 Chromium)에 HTML 렌더링
html2canvas로 DOM을 캔버스에 그린 뒤 페이지 단위로 분할jspdf로 PDF를 조립하여 디스크에 저장
개발자
- 이광호 (leekh4232@gmail.com)
라이선스
MIT
| |
