HWP Skill

한컴오피스 한글(.hwp/.hwpx) 문서 생성 및 편집을 위한 Claude Skill.

한국 정부과제 연구개발계획서, 사업계획서, 공공 보고서, 학술 논문 등 HWPX 포맷 산출물이 필요한 작업에 사용한다.

주요 기능

• 마크다운 → HWPX 변환: 구조화된 마크다운을 한컴 HWPX 포맷으로 변환
• 정부과제 포맷 지원: 돋움체 12pt 본문, □/o/- 3단계 불릿 계층, 테이블 스타일 내장
• 커스텀 템플릿: 사용자 제공 양식 파일(--template) 지원
• HWPX 구조 검사: inspect_hwpx.py로 파일 구조, 스타일 사용 현황 확인
• linesegarray 제거: 텍스트 겹침 버그를 유발하는 렌더 캐시 자동 배제

사용법

기본 변환

python scripts/md2hwpx.py input.md output.hwpx

커스텀 템플릿 사용

python scripts/md2hwpx.py input.md output.hwpx --template /path/to/custom_form.hwpx

테이블 스타일 변경

python scripts/md2hwpx.py input.md output.hwpx --table-style table

구조 검사

python scripts/inspect_hwpx.py output.hwpx --show-styles

디렉토리 구조

hwp/
├── SKILL.md                       # Skill 메타/가이드
├── README.md                      # 본 문서
├── scripts/
│   ├── md2hwpx.py                 # 마크다운 → HWPX 변환기
│   └── inspect_hwpx.py            # HWPX 구조/스타일 검사
├── references/
│   ├── hwpml_schema.md            # HWPML XML 스키마 참조
│   └── style_guide.md             # 스타일 ID 매핑 가이드
└── assets/
    └── templates/
        ├── career_base.hwpx       # 기본 템플릿 (정부과제용)
        └── table_style.hwpx       # 테이블 강조형 템플릿

지원 마크다운 구문

# 제목                        → 돋움체 14pt bold
## 절 제목                    → 돋움체 13pt bold
### 소제목                    → 돋움체 12pt bold

일반 본문                     → 돋움체 12pt

- 레벨 0 불릿                 → □ 레벨 0 불릿
  - 레벨 1 불릿               →   o 레벨 1 불릿
    - 레벨 2 불릿             →     - 레벨 2 불릿

1. 번호 리스트

| 헤더 A | 헤더 B |
| --- | --- |
| 내용 1 | 내용 2 |

제한사항

• 인라인 bold/italic은 평문으로 처리 (수동 <hp:run> 분리 필요)
• 이미지, 각주, 페이지 번호, 머리글/바닥글 미지원
• 편집은 재생성만 가능 (in-place 편집 미지원)
• 추적 변경/주석 미지원

라이선스

Proprietary. 자세한 내용은 LICENSE 참조.