Word를 Jupyter Notebook으로

사람들이 Word 문서를 Jupyter Notebook으로 바꾸는 이유

데이터 사이언스 과제를 제출해 보았거나, 학생의 분석을 채점해 보았거나, 당신은 Jupyter인데 동료는 Microsoft Word에만 머무는 협업을 해 보았다면 형식 간격이 얼마나 답답한지 잘 압니다.

Word 문서는 어디에나 있습니다. 실제 분석이 도는 곳은 Jupyter Notebook입니다.

문제는 반복됩니다. 학생은 Word로 쓰지만 강의는 .ipynb를 요구합니다. 데이터 과학자는 방법론을 Word에 적었다가 실행 가능한 코드 셀이 필요합니다. 연구자는 Word로 보고서를 쓰고 처음부터 다시 하지 않고 라이브 Python 시각화를 더하고 싶습니다.

그래서 이 변환기가 있습니다. Word 문서(.docx)를 끌어다 놓으면 깔끔한 Jupyter Notebook(.ipynb)을 받습니다. 본문은 Markdown 셀, 코드 블록은 실행 가능한 코드 셀, 제목은 일관된 Markdown 계층으로 매핑됩니다. 복사-붙여넣기 없음. 재서식 없음. 까다로운 명령줄에 주말을 빼앗기지 않습니다.

변환이 작동하는 방식, 단계별로

Word에서 Jupyter로 가는 것은 마법이 아니라 구조화된 텍스트 변환입니다. .docx는 XML 패키지이고 노트북은 JSON입니다. 변환기는 구조를 읽고 각 요소를 올바른 셀 유형에 매핑하여 JupyterLab, VS Code, Google Colab이 네이티브로 여는 유효한 .ipynb를 씁니다.

파일을 업로드하면 다음이 일어납니다:

1. 1

   Word 문서 구조 파싱

   도구가 .docx를 읽고 단락, 제목(H1–H6), 코드 스타일 블록, 표, 목록, 포함 이미지를 식별하며 순서를 유지합니다.

2. 2

   내용을 셀 유형에 매핑

   단락과 제목은 Markdown 셀입니다. 고정폭이나 코드로 표시된 단락은 코드 셀입니다. GFM 표를 켜면 표는 Markdown 셀 안의 Markdown 표가 됩니다.

3. 3

   .ipynb JSON 만들기

   유효한 nbformat 4.5 구조를 조립합니다. JupyterLab, VS Code, Colab이 기대하는 형식입니다. 메타데이터, 커널 힌트, 셀 ID가 자동 생성됩니다.

4. 4

   미리보기 및 다운로드

   몇 초 안에 .ipynb가 준비됩니다. 변환은 브라우저에서 로컬로 실행되며 .docx는 서버로 업로드되지 않고 다운로드까지 이 탭에 비공개로 남습니다.

Pandoc으로 .docx를 .ipynb로 (CLI)

Pandoc은 문서 변환의 사실상 표준입니다. 2.11부터 docx → ipynb를 네이티브 지원합니다. 설치되어 있으면 한 줄 명령이면 될 때가 많습니다.

pandoc my-report.docx -o my-notebook.ipynb

for f in *.docx; do pandoc "$f" -o "${f%.docx}.ipynb"; done

Pandoc은 Word 제목 스타일을 Markdown 제목(#, ##)으로 Markdown 셀에 매핑하고, 단락은 Markdown으로, 코드 스타일 텍스트는 코드 셀로 옮깁니다 — 구조적으로 충실하고 완전히 오프라인입니다.

Python으로 .docx를 .ipynb로

프로그램 방식 제어가 필요할 때 — 예를 들어 특정 키워드로 시작하는 단락을 코드 셀로 — python-docx와 nbformat을 사용하세요.

단락을 순회해 Markdown과 코드를 고르고 노트북 객체에 셀을 추가하는 짧은 스크립트로 완전히 맞춤형 파이프라인을 만듭니다.

pip install python-docx nbformat