pypandoc-hwpx (msjang)

pypandoc-hwpx는 Pandoc을 기반으로 md·html·docx를 hwpx로 변환하는 Python 도구입니다. 2025년 12월에 공개돼 2026년 8월 기준 스타 177개·포크 38개를 기록 중입니다.

방향이 반대인 도구

대부분의 HWP 도구는 “HWP를 읽어서 다른 포맷으로” 갑니다. pypandoc-hwpx는 반대로 다른 포맷을 HWPX로 만듭니다. 이 방향이 필요한 순간이 실무에는 꽤 있습니다.

어떤 상황에서 쓰나

• Markdown으로 문서를 작성했는데 제출은 한글 파일로 해야 할 때
• AI로 생성한 보고서를 HWPX로 내려받아야 할 때
• 웹 기반 문서 시스템에서 한글 파일을 내보내야 할 때
• 논문·보고서를 Markdown으로 관리하고 제출본만 변환할 때

Pandoc을 쓴 이유

Pandoc은 문서 변환의 사실상 표준 도구로, 수십 개 포맷 간 변환을 이미 지원합니다. 여기에 HWPX 출력을 추가하면 “Pandoc이 읽을 수 있는 모든 포맷 → HWPX” 경로가 한 번에 열립니다. 개별 변환기를 여러 개 만드는 대신 기존 허브에 출구 하나를 붙이는 영리한 접근입니다.

기여 형태로서의 의미

새 도구를 만드는 대신 널리 쓰이는 도구에 한국 특화 기능을 추가하는 방식입니다. 사용자 입장에서는 이미 쓰던 워크플로에 그대로 들어오므로 학습 비용이 거의 없습니다.

큰 오픈소스에 한국 포맷 더하기

큰 오픈소스에 자기 나라 포맷 지원을 추가하는 것도 유효한 기여 경로입니다. 처음부터 다 만들지 않아도 되고, 기존 도구의 사용자 기반을 그대로 물려받습니다.

같은 결의 한국 HWP 변환 프로젝트

• kordoc (파싱·비교·생성 종합)
• hwpxskill (HWPX 서식 보존 편집)
• hwplib · hwpxlib (Java 라이브러리)
• rhwp (뷰어·에디터)

이런 분께 맞아요

• Markdown으로 쓰고 한글 파일로 제출해야 하는 연구자·실무자
• AI 생성 문서를 HWPX로 내려받아야 하는 서비스
• 문서 변환 파이프라인을 구축하는 개발자
• Pandoc 확장을 만들어보려는 개발자