사용 가이드¶

HWP Parser의 다양한 기능을 활용하는 방법을 안내합니다.

어떤 가이드를 찾고 계신가요?¶

시나리오	추천 가이드
(설치 없음) 웹 브라우저에서 바로 체험하고 싶다	🌐 Hugging Face Spaces
HWP 파일을 텍스트/HTML/Markdown으로 변환하고 싶다	📦 Core 사용법
커맨드라인에서 HWP 파일을 일괄 변환하고 싶다	💻 CLI 사용법
LlamaIndex로 HWP 문서 기반 RAG를 구축하고 싶다	🦙 LlamaIndex 어댑터

기능	Core	CLI	LlamaIndex
Python 코드에서 직접 호출	✅	❌	✅
커맨드라인 사용	❌	✅	❌
병렬 처리 (Worker)	✅	✅	❌
RAG 파이프라인 통합	❌	❌	✅
추가 설치 필요	❌	❌	`[llama-index]`

클래스	모듈	용도
`HWPConverter`	`hwp_parser.core`	HWP → 텍스트/HTML/Markdown/ODT 변환
`ConversionResult`	`hwp_parser.core`	변환 결과 데이터 (txt/md/odt)
`HTMLDirResult`	`hwp_parser.core`	HTML 변환 결과 (xhtml/css/bindata)
`HWPReader`	`hwp_parser.adapters.llama_index`	LlamaIndex Document 로더

from hwp_parser import HWPConverter
result = HWPConverter().to_markdown("document.hwp")

hwp-parser convert *.hwp --format markdown --workers 4

from hwp_parser import HWPReader
docs = HWPReader().load_data("document.hwp")