hwp2LLM v1.0 사용법

들어가며

이번주 초대용량 한글 문서 변환기 hwp2LLM을 첫번째 v1.0 버전으로 배포했습니다. 쉽다고 생각했으나 아직 어렵다는 연락이 와서 쉽게 다시 풀어서 올려 드립니다.

우선 이 앱의 작동 원리에 대해서 설명을 드립니다. 한글과컴퓨터는 기업들의 자동화 업무를 돕기 위해 ‘한글 오토메이션 API’라는 기능을 공식적으로 열어두었습니다. hwp2LLM은 이 공식 매뉴얼의 명령어를 사용하여 한글 프로그램에게 “파일을 열어라”, “TXT로 저장해라”, “PDF로 변환해라” 라고 지시합니다. hwp2LLM은 바로 이런 기능을 적극 활용하여 작동합니다. 앱 안의 코드가 HWP 파일 내부를 직접 뜯어고치는 것이 아니라, 한글 프로그램 본연의 저장 기능을 활용하므로 변환 결과물이 매우 정확합니다.

1. 작동환경 확인

최종 결과물인 txt, pdf 파일들은 맥에서도 잘 보입니다만, 모든 변환은 윈도우 PC에서 작업을 해야 합니다. 변환이 원활하게 작동하기 위해서는 아래의 작업 환경이 마련되어야 합니다.

• 한글과 컴퓨터 2018 (2014 이후 버전이 가능하리라 예상)
• 윈도우 11 (10 이후 버전이 가능하리라 예상)

준비된 상태에서 hwp2LLM.exe 을 실행하면 화면에는 보이지 않지만, 백그라운드 PC에 설치된 ‘진짜 한글 프로그램’이 실행됩니다. 이는 윈도우의 COM(Component Object Model)이라는 기술 덕분입니다. 앱 속의 코드인 파워셸이 보이지 않는 리모컨이 되어 한글 프로그램을 직접 조종합니다.

2. 다운로드

우선 최신 hwp2LLM.exe 파일을 다운 받아야 합니다. 스크립트 안에는 다양한 상황에 대응하는 코드가 있기 때문에 편리하고 안전하도록 컴파일하여 배포 전문 플랫폼인 GitHub에서만 배포하고 있습니다. 따라서 블로그나 까페가 아니라 아래의 배포 사이트에서 파일을 받습니다.

https://github.com/physhero/hwp2LLM

3. 파일 실행 후 폴더 지정

다운 받은 hwp2LLM_v1.0.x.exe 을 다운 받은 이후 실행하면 알 수 없는 게시자 이기 때문에 파란 경고문이 나옵니다. 본 앱은 해킹 코드를 한줄도 넣지 않았으며 버전업을 할 때마다 바이러스 검색 결과를 같이 올리고 있습니다. [게시자] 부분에 제 이름을 넣기 위해서는 연간 엄청난 비용이 들더라고요. 가장 최신 버전으로 공식 배포사이트인 GitHub에서 다운 받으신 분은 [추가정보] > [실행]을 클릭하면 바로 실행됩니다.

그 다음으로 이전 영상 처럼 폴더를 물어보고 나의 폴더를 지정해 주면 변환이 시작됩니다.

Play

4. 로그파일 확인

hwp2LLM 은 윈도우 화면에 정보를 나타내기 보다 주요 작업 내용은 txt 파일로 저장합니다.

• hwp_file_list_20260922_231501.txt (한글 파일을 검색한 결과)

H:\내 드라이브\Utils\hwps\hwps\draft\과정 중심 평가를 적용한 과학교육 교수·학습 모델 실증 연구.hwp
H:\내 드라이브\Utils\hwps\hwps\draft\디지털 기반 과학교육 환경 조성을 위한 교원 탐구지도 역량 강화 방안.hwp
H:\내 드라이브\Utils\hwps\hwps\draft\미래 융합형(STEAM) 과학교육 프로그램 개발 및 현장 적용 연구.hwp
H:\내 드라이브\Utils\hwps\hwps\2008 - 연구사업계획서.hwp
H:\내 드라이브\Utils\hwps\hwps\2010 - 발표자료 - 창의과학교육.hwp
H:\내 드라이브\Utils\hwps\hwps\에듀테크 및 가상실험(VR) 활용을 통한 과학교육 학습자 흥미도 분석 연구.hwp
H:\내 드라이브\Utils\hwps\hwps\영재교육 교수학습 자료.hwp
H:\내 드라이브\Utils\hwps\hwps\학생 교육 연구 자료집 모음.hwp

• hwp_convert_log_20260922_231501.txt (파일 변환 결과: 성공/실패/스킵)

==========================================================================
HWP to PDF/TXT Conversion Started: 2026-09-22 23:28:30
Source Folder : H:\내 드라이브\Utils\hwps\hwps
HWP List File : H:\내 드라이브\Utils\hwps\hwp_file_list_20260922_232821.txt
Total Files : 8
23:28:30 - [1/8] - SKIP_EXISTING - ...
23:31:27 - [7/8] - SUCCESS -H:\내 드라이브\Utils\hwps\hwps\영재교육 교수학습 자료.hwp -> PDF & TXT
23:31:43 - [8/8] - SUCCESS -H:\내 드라이브\Utils\hwps\hwps\학생 교육 연구 자료집 모음.hwp -> PDF & TXT

5. 마치며

GitHub에서 파일 다운과 실행만 할 수 있다면 다른 어려움은 없을 것이라 생각합니다. 그러니 본인이 갖고 있던 파일들을 바로 변환하여 맥이나 AI에 적극 활용하시기 바랍니다.

변환은 시간이 걸리기 때문에 조금씩 바로 시작하는 것이 좋습니다. 그리고 앱 내부에 SKIP 기능이 있기 때문에 멈추고 재시작 하여도 완료한 파일은 건너뛰고 신속한 변환을 하도록 작동합니다.