지원
궁금한 점은 먼저 아래 질문과 사용 안내를 확인해 주세요. 버그를 발견했거나 해결되지 않는 문제가 있으면 이메일로 알려 주세요.
문의: halo@levelupsoft.com (Levelupsoft Inc.)
문의할 때 hunsdoc --version 결과, 운영체제, 실행한 명령과 오류 메시지를 알려 주시면 빠르게 도와드릴 수 있습니다.
개인정보가 담긴 원본 문서는 보내지 마세요. 재현에 문서가 꼭 필요하면 먼저 hunsdoc redact로 가리거나 내용을 바꾼 사본을 만들어 주세요.
자주 묻는 질문
정말 무료인가요? 회사·기관에서 써도 되나요?
네. hunsdoc은 MIT 라이선스로 무료 배포합니다. 개인·기관·회사 어디서나 쓰고, 고치고, 다시 배포할 수 있습니다. 다시 배포할 때는 압축 파일에 든 LICENSE·NOTICE의 저작권·라이선스 고지를 함께 유지해 주세요. 받는 곳은 다운로드 페이지입니다.
MS 워드·엑셀 문서도 되나요?
네. 워드(DOCX)와 엑셀(XLSX, 97-2003 형식 XLS)을 Markdown·JSON으로 바꾸고, 개인정보를 가린 Markdown도 만듭니다. 엑셀은 시트마다 제목과 표로 나오고, 수식 칸은 파일에 저장된 계산 결과가 나옵니다. MS Office가 설치되어 있지 않아도 됩니다.
구형 워드(.doc)와 파워포인트(.ppt·.pptx)는 읽지 못합니다. 워드 문서는 워드에서 DOCX로 다시 저장하면 읽을 수 있습니다. 렌더링·서식 보존 편집·공문서 생성은 한글 문서 전용입니다.
한글(한컴오피스)이 설치되어 있어야 하나요?
아니요. hunsdoc은 HWP·HWPX 파일을 직접 읽고 씁니다. 한글이 없는 서버나 Linux에서도 그대로 동작합니다.
인터넷 연결이 필요한가요?
아니요. 문서를 변환·생성·가리는 동안 외부와 통신하지 않습니다. 외부로 나가는 요청은 폴더 감시의 --webhook 알림 하나뿐이며, HUNSDOC_OFFLINE=1로 그것까지 막을 수 있습니다.
kordoc과는 어떤 관계인가요?
hunsdoc은 오픈소스 문서 파서 kordoc(TypeScript)을 Go로 옮긴 구현입니다. 같은 입력에 같은 결과를 내는 것을 목표로, 변환 결과를 원본 구현과 바이트 단위로 대조하며 개발합니다. 실행에 Node.js가 필요 없고 단일 파일로 배포된다는 점이 다릅니다.
표가 원본과 다르게 보이거나 깨져요.
병합 칸이 많은 표는 --html-tables로 HTML 표로 받아 보세요. 테두리 없이 배치용으로 쓴 “틀 표”는 기본으로 글로 풀리는데, 원래 표 구조가 필요하면 --keep-layout-tables를 쓰세요. PDF에서 상자를 표로 잘못 읽어 순서가 뒤집힌다면 --no-tables가 도움이 됩니다.
스캔한 PDF에서 글이 거의 나오지 않아요.
글자층이 없는 그림 문서입니다. Tesseract 같은 OCR 프로그램을 설치한 뒤 HUNSDOC_OCR_PROVIDER=tesseract hunsdoc 스캔.pdf --ocr로 실행하세요. 자세한 방법은 사용 안내의 OCR에 있습니다.
암호가 걸린 문서를 열 수 있나요?
HWPX·HWP(3.x·5.x) 암호 문서는 --password로 엽니다. 한컴 DRM이 걸린 문서에는 적용되지 않습니다.
개인정보 가리기 결과를 그대로 공개해도 되나요?
자동 검출을 돕는 도구이므로 반드시 사람이 결과를 확인해 주세요. 그림 속 글자는 찾지 못합니다. PDF는 원본 파일을 고치지 않고 가린 Markdown만 만들므로, PDF 원본을 공개하려면 PDF 편집기의 가림 기능을 써야 합니다.
PNG나 PDF로 렌더링할 수 있나요?
지원하지 않습니다. hunsdoc은 SVG와 HTML까지 그립니다. 그림이 필요하면 SVG를 브라우저나 변환 도구로 바꿔 쓰세요.
버전 기록
0.1.1 — 2026년 10월 2일
- 손상된 HWP 파일에서 프로그램이 비정상 종료하던 문제를 고쳐, 원본 구현처럼 관대한 판독으로 넘어가게 했습니다.
- 일부가 손상된 HWPX·ZIP 문서를 원본 구현과 같은 규칙으로 열고 복구합니다.
- 루트 정보가 깨진 PDF를 원본 구현과 같이 판정합니다.
- 손상 문서의 오류 메시지에 파일 내용이 섞여 나오던 문제를 고쳤습니다.
- Go 1.26.6으로 빌드해 표준 라이브러리의 알려진 취약점에 대응했습니다(govulncheck 0건).
0.1.0 — 2026년 10월 2일
- 첫 릴리스. HWP·HWPX·PDF·XLSX·DOCX 등 변환, 공문서 생성, 서식 보존 편집, 서식 채우기·도장, 개인정보 가리기, SVG·HTML 렌더링, 폴더 감시, MCP 서버(도구 17개).
라이선스와 오픈소스 고지
hunsdoc은 kordoc(© 2026 chrisryugj)을 Go로 이식한 소프트웨어이며 MIT 라이선스로 제공됩니다. 배포 파일에는 LICENSE, NOTICE, THIRD_PARTY/가 함께 들어 있습니다. 이식 과정에서 다음 오픈소스의 알고리즘·코드를 바탕으로 했습니다.
| 구성 요소 | 라이선스 | 쓰인 곳 |
|---|---|---|
| kordoc | MIT | 파서·생성기·편집·가리기·렌더 전반(원본 구현) |
| OpenDataLoader PDF (Hancom, Inc.) | Apache-2.0 | PDF 표 감지 알고리즘 |
| hml-equation-parser | Apache-2.0 | HWPX 수식 → LaTeX 변환 |
| js-cfb (SheetJS) | Apache-2.0 | HWP 5.x 컨테이너 해석 규칙 |
| rhwp | MIT | 손상 컨테이너 판독, 배포용·암호 문서 처리 |
| claw-hwp | MIT | 차트 생성, 도장 배치, 서식 채우기 규칙, 구조 검증 |
| giraffesyo/pdf (포크) | MIT | 순수 Go PDF 엔진 |