서버에서 HWP를 PDF로 — miwork hangul

miwork hangul은 HWP 문서를 서버에서 PDF로 변환하고, 그 결과를 웹에서 바로 확인할 수 있게 합니다.

한두 개의 한글 문서를 열어 PDF로 저장하는 일은 익숙합니다. 그러나 수백 개, 수천 개의 문서를 검색용 데이터로 만들거나 PDF로 일괄 변환하려고 하면 이야기가 달라집니다.

문서마다 열기와 저장을 반복해야 하고, 중간에 멈추면 사람이 확인해야 합니다. 검색용 본문을 추출하거나 문서 미리보기를 만드는 작업도 마찬가지입니다. miwork hangul은 이 과정을 서버에서 반복 실행할 수 있는 문서 처리 기능으로 만들기 위해 시작했습니다.

HWP → PDF를 가장 먼저 다루는 이유

miwork hangul이 가장 중요하게 보는 기능은 HWP → PDF 변환입니다.

PDF가 만들어지면 별도 프로그램 없이 브라우저에서 문서를 확인할 수 있고, 검색 결과 미리보기나 문서 보관 같은 다음 작업으로 연결하기도 쉽습니다.

업로드한 PDF는 HWPX로 재구성할 수 있습니다. 이 기능은 원본 편집 구조를 완벽하게 복원한다기보다, PDF의 텍스트와 이미지를 다시 편집할 수 있는 문서로 만드는 실용적인 변환에 초점을 둡니다.

한글 문서 변환이 까다로운 이유

HWP 문서는 단순한 텍스트 묶음이 아닙니다. 글꼴, 글자 모양, 문단, 표, 도형, 이미지, 머리말·꼬리말, 각주와 페이지 배치 정보가 함께 결과 화면을 만듭니다. 같은 본문이라도 사용 가능한 글꼴이나 레이아웃 계산 방식이 달라지면 줄바꿈과 페이지 수가 달라질 수 있습니다.

웹의 HTML처럼 브라우저가 공통으로 제공하는 DOM을 그대로 이용할 수 있는 형식도 아닙니다. 한컴은 HWP Automation 개발 가이드와 HWPX/OWPML 관련 오픈소스 자료를 제공하지만, 이를 활용한 데스크톱 자동화와 Linux 서버에서의 대량 처리는 서로 다른 실행 환경과 설계가 필요합니다.

이 차이는 특정 제품의 부족함이라기보다, 오랫동안 축적된 문서 형식을 서로 다른 환경에서 재현할 때 마주치는 기술적 과제에 가깝습니다.

변환 범위를 넓혀온 과정

지난 6개월 동안 다양한 HWP 문서의 변환 결과를 비교하며 지원 범위를 넓혔고, 내부 테스트에서 80% 이상의 변환 성공률을 확인했습니다. 여기서 성공은 변환이 오류 없이 끝나고 주요 본문과 페이지 구성을 확인할 수 있는 결과를 뜻합니다.

이 과정에서 개선한 HWP 해석과 PDF 생성 기능은 SoliDocs Viewer의 한글 문서 보기 기능에도 반영됐습니다. 아직 복잡한 차트와 수식, 특수 개체, 특정 글꼴과 정교한 페이지 배치처럼 해결할 사례가 남아 있습니다. 데모에서 보관에 동의한 문서와 사용자가 표시한 문제 구간을 유형별로 분석해 남은 부분을 채워갈 계획입니다.

성공률은 현재 내부 테스트 문서를 기준으로 한 관찰값이며 제품 보증 수치가 아닙니다. 문서 구성과 글꼴, 개체 종류에 따라 결과가 달라질 수 있고, 테스트 표본이 늘어나면 기준도 함께 갱신할 예정입니다.

서버에서 이어지는 활용

miwork hangul은 한글 프로그램이 설치되지 않은 Linux 컨테이너에서 동작하며 서버 API로 연결할 수 있습니다. 여러 문서의 PDF 일괄 생성, 웹 미리보기, RAG와 문서 AI 전처리 같은 작업에 활용할 수 있습니다.

실제 문서로 확인하기

miwork hangul 데모에서는 HWP·HWPX 문서를 PDF로 변환해 브라우저에서 확인하고 내려받을 수 있습니다. 어긋난 부분이 보이면 유형과 페이지를 표시할 수 있으며, PDF를 편집 가능한 HWPX로 재구성하는 기능도 시험할 수 있습니다.

miwork hangul 데모 열기 →