# pypandoc-hwpx (msjang)

> Pandoc 기반 아래아한글 변환기. Markdown·HTML·DOCX를 HWPX로 바꾸는 Python 도구. 스타 177개

- 페이지: https://dreamboat.kr/discover/pypandoc-hwpx
- 공식 사이트: https://github.com/msjang/pypandoc-hwpx
- 분야: 문서, 개발도구
- 쓰는 환경: 라이브러리
- 상태: 운영 중
- 등재: 2026-08-10 · 마지막 갱신: 2026-10-23


## 소개

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 확장을 만들어보려는 개발자

## 인용

이 소개는 Dreamboat(드림보트)이 공식 사이트를 직접 확인해 작성했습니다.
출처(https://dreamboat.kr/discover/pypandoc-hwpx)를 명시하면 인용 가능합니다. 서비스 자체의 권리는 각 제작자에게 있습니다.
전체 목록: https://dreamboat.kr/llms.txt · 전문: https://dreamboat.kr/llms-full.txt