I-Hate-Hancom for Claude — Markdown → HWPX 자동 변환 스킬
npx claudepluginhub tjdwls101010/i-hate-hancom_for_claudeMarkdown → HWPX 자동 변환 Claude Code Skill. 한컴 서식 없이 정부 공문서 수준의 HWPX 문서를 생성한다.
tjdwls101010
→
한컴 서식 지옥에서 해방 — Markdown → HWPX 자동 변환 Claude Code Skill
대한민국에는 독특한 문서 생태계가 있다. 전 세계가 .docx, .pdf, 마크다운을 쓸 때, 한국의 공공기관과 기업은 **한컴오피스 한글(.hwp/.hwpx)**을 사실상 표준으로 사용한다.
이 포맷이 비효율적인 이유는 구조적이다:
.hwp는 바이너리 포맷이고, .hwpx는 ZIP 안의 XML이다. 어느 쪽이든 git diff로 변경 사항을 추적할 수 없어 협업 워크플로우에 통합되지 않는다.이 스킬은 마크다운으로 작성하고 한컴 포맷으로 출력하는 방식으로, 서식에 소비되는 시간을 구조적으로 제거한다.
▢/○/▷ 한국 공문서 기호 체계1. 사용자 지정 → 플러그인 탐색 진입
2. 플러그인 탐색 클릭
3. + → 마켓플레이스 추가
4. URL 입력 후 동기화
https://github.com/tjdwls101010/I-Hate-Hancom_for_Claude.git
5. I-Hate-Hancom 플러그인 설치
6. 마크다운 파일을 업로드하면 Hancom 스킬이 자동으로 트리거된다
마크다운 파일을 업로드하거나 자연어로 요청하면 Hancom 스킬이 자동으로 트리거된다:
https://github.com/user-attachments/assets/e0a84763-50e5-43fb-802d-2af6ba8a9c03
Claude Code에서 자연어로 요청하면 된다:
"이 마크다운 파일을 한컴 공문서로 변환해줘"
"hwpx로 만들어줘"
"보도자료 형식으로 작성해줘"
"이 hwpx 파일 읽어줘"
# 1. 마크다운 린트
python3 .claude/skills/Hancom/Scripts/md_lint.py input.md
# 2. 변환 + 빌드
python3 .claude/skills/Hancom/Scripts/md_to_hwpx.py input.md --output output.hwpx --build --title "문서 제목"
# 3. HWPX 읽기
python3 .claude/skills/Hancom/Scripts/read_hwpx.py document.hwpx
# 4. HWPX 검증
python3 .claude/skills/Hancom/Scripts/validate_hwpx.py document.hwpx
graph LR
A["📝 Markdown"] --> B["🧹 md_lint.py"]
B --> C["✍️ Content Prep"]
C --> D["⚙️ md_to_hwpx.py"]
D --> E["📦 build_hwpx.py"]
E --> F["📄 .hwpx"]
style A fill:#e8f5e9
style F fill:#fff3e0
| 단계 | 도구 | 하는 일 |
|---|---|---|
| Lint | md_lint.py | 기계적 마크다운 정리 — 제목 레벨 갭, 연속 빈줄, 리스트 간 빈줄, 후행 공백 |
| Content Prep | Claude (수동) | 의미 판단이 필요한 정규화 — 구조 재배치, 불렛→표 변환, <!-- box:note --> 등 어노테이션 |
| Convert | md_to_hwpx.py | 어노테이션된 마크다운 → section0.xml (XML 템플릿 기반 생성) |
| Build | build_hwpx.py | section0.xml + header.xml + 이미지 → .hwpx ZIP 아카이브 |
HWPX는 ZIP 아카이브다. 안에 XML 파일들이 들어 있다:
document.hwpx (ZIP)
├── mimetype ← 반드시 첫 번째 엔트리 (STORED, 비압축)
├── META-INF/container.xml
├── Contents/
│ ├── header.xml ← "CSS" — 모든 스타일을 ID로 정의
│ ├── section0.xml ← "HTML" — 본문 내용, 스타일 ID 참조
│ └── content.hpf
├── settings.xml
└── version.xml