HWP / HWPX를 이미지로 미리보기
.hwp 파일을 읽으면 텍스트 내용은 얻을 수 있지만, 모양은 알 수 없습니다. 이 스킬은 rhwp 자체 레이아웃 엔진을 사용하여 페이지를 이미지로 렌더링하므로, 한글 문서를 살펴보거나 방금 생성한 문서를 확인할 때 한컴오피스 없이도 가능합니다.
사용 방법
node "${CLAUDE_PLUGIN_ROOT}/scripts/hwp-preview.mjs" "<file.hwp|.hwpx>" "<outdir>" --png
그런 다음 Read 도구로 생성된 PNG 파일을 열어 실제로 확인하세요.
옵션:
| 옵션 | 설명 |
|---|---|
--png | PNG도 함께 출력 (래스터라이저로 Chrome/Chromium/Edge 필요). 생략 시 SVG만 출력. |
--scale <n> | PNG 픽셀 비율, 기본값 2. 간단히 보려면 1, 자세히 보려면 3 사용. |
--pages <spec> | 1부터 시작하는 페이지. 예: 1, 1,3, 2-4. 기본값: 모든 페이지. |
출력 파일 이름은 <stem>-<format>-p<N>.svg / .png 형식입니다. 예: report-hwp-p1.png.
일반적인 사용 사례
- 생성된 출력 확인.
hwp-write.mjs실행 후, 사용자에게 파일을 전달하기 전에 1페이지를 미리보기하여 제목 계층, 표 테두리, 간격을 확인하세요. - 사용자가 보낸 문서 검사. 질문이 텍스트가 아닌 시각적 문제(예: "표가 왜 깨졌지?")일 때 사용합니다.
- 사용자에게 결과물 미리 보여주기. 한글을 열어보라고 요청하지 않고도 확인할 수 있습니다.
참고 사항
--png를 사용했을 때 브라우저를 찾지 못해 실패하면CHROME_PATH를 Chrome/Chromium/Edge 실행 파일 경로로 설정하거나,--png를 생략하고 Node만 있으면 되는 SVG를 사용하세요.- 이 렌더러는 rhwp의 것이며 한컴의 것과 다릅니다. 글꼴과 페이지 나눔은 유사하지만 완전히 동일하지 않으며, 시스템에 실제로 설치된 글꼴로 대체됩니다. 최종 시각적 확인을 위해서는 사용자가 한글에서 파일을 열어야 합니다.
- Node.js가 필요합니다 (Cowork VM / Claude Code 환경에서 사용 가능).