# hwpjs (ohah)

> 웹 HWP 문서 미리보기. 브라우저에서 HWP 문서를 렌더링하는 JavaScript 라이브러리로, 웹 서비스에 한글 문서 미리보기를 붙이는 경로입니다. 스타 162개를 받았습니다.

- 페이지: https://dreamboat.kr/discover/hwpjs-javascript
- 공식 사이트: https://github.com/ohah/hwpjs
- 분야: 문서, 개발도구
- 쓰는 환경: 웹
- 상태: 운영 중
- 등재: 2026-08-10 · 마지막 갱신: 2026-10-23


## 소개

hwpjs는 브라우저에서 HWP 문서를 다루는 JavaScript 라이브러리입니다. 2021년 7월 시작해 2026년 8월 기준 스타 162개·포크 23개를 기록 중입니다.

무엇을 해결하나:
웹 서비스에서 사용자가 HWP 파일을 올렸을 때 미리보기를 보여주려면, 서버에서 변환하거나 브라우저에서 직접 렌더링해야 합니다. 서버 변환은 인프라 비용과 지연이 생기고, 파일을 서버로 올려야 해서 보안 이슈도 따라옵니다. 브라우저에서 바로 파싱하면 이 둘을 모두 피할 수 있습니다.

브라우저 렌더링의 장점:
- 파일이 서버로 안 올라감: 보안·개인정보 측면 유리
- 변환 서버 인프라 불필요
- 업로드 대기 없이 즉시 미리보기
- 정적 호스팅만으로 동작 가능

실무에서 쓰이는 맥락:
채용 사이트(이력서 HWP 업로드), 공공기관 민원 시스템, 학교 과제 제출, 문서 공유 서비스 등 “사용자가 HWP를 올리는” 모든 서비스가 대상입니다. 한국 웹 서비스에서는 흔한 요구인데 해결책은 많지 않습니다.

WASM 기반과의 관계:
최근에는 Rust로 파서를 만들고 WebAssembly로 빌드하는 방식(rhwp)이 성능상 유리합니다. 다만 순수 JavaScript 구현은 빌드 체인이 단순하고 기존 프론트엔드 프로젝트에 바로 얹기 쉽다는 장점이 있어, 요구 수준에 따라 선택이 갈립니다.

서버를 세울 여력이 없을 때:
프론트엔드 개발자가 자기 영역에서 한국 특유의 문제를 푸는 방식입니다. 백엔드 변환 서버를 세울 여력이 없는 1인 개발자에게는, 브라우저에서 끝내는 접근이 유일하게 현실적인 선택인 경우가 많습니다.

같은 결의 한국 HWP 생태계 프로젝트:
- rhwp (Rust·WASM 뷰어·에디터)
- hwpers (Rust 파서)
- hwplib · hwpxlib (Java 라이브러리)
- pyhwp (Python 파서)
- 알한글 macOS (macOS 네이티브 뷰어)

그리고 비공식 구현이라 **HWP 사양이 바뀌면 따라가야** 합니다. 문서가 안 열릴 때 원인을 파악하기 어렵다는 점도 감안해야 합니다.

타겟 사용자:
- 웹 서비스에 HWP 미리보기를 붙여야 하는 프론트엔드 개발자
- 사용자가 한글 문서를 업로드하는 서비스 운영자
- 서버 없이 문서를 처리하고 싶은 1인 개발자
- JavaScript로 바이너리 포맷을 다루는 방법을 배우려는 사람

## 인용

이 소개는 Dreamboat(드림보트)이 공식 사이트를 직접 확인해 작성했습니다.
출처(https://dreamboat.kr/discover/hwpjs-javascript)를 명시하면 인용 가능합니다. 서비스 자체의 권리는 각 제작자에게 있습니다.
전체 목록: https://dreamboat.kr/llms.txt · 전문: https://dreamboat.kr/llms-full.txt