읽기, 변환, 편집을 위한 클로드 코드 기술 Korean Hangul document (.hwp / .hwpx]) - Hancom Office없이.

왜

한국 정부 양식, 학술 템플릿 및 기관 문서는 .hwp 파일로 배포됩니다. 일반적으로 Hancom Office (Windows-only 구독)가 필요합니다. 이 기술은 어떤 OS에 HWP/HWPX를 사용하기위한 완벽한 파이프라인을 제공합니다.

특징

빠른 시작

##1. 설치

##2. Claude 코드 사용

HWP/HWPX 파일 또는 한국어 문서 편집을 언급할 때 기술이 자동으로 활성화됩니다. 예제:

• “이 HWP를 Markdown으로 변환”
• “이 정부 양식의 위주자”
• “이 HWPX 파일에서 텍스트를 추출”

##3. 스크립트를 직접 사용

**HWPX에서 텍스트를 삭제: **

장소:

** HWP를 HWPX로 변환:**

프로젝트 구조

# # Acknowledgments에

이 기술은 다음과 같이 작동합니다

hwp-pipeline

A Claude Code skill for reading, converting, and editing Korean Hangul documents (.hwp / .hwpx) — without Hancom Office.

Why

Korean government forms, academic templates, and institutional documents are distributed as .hwp files. Editing them typically requires Hancom Office (Windows-only subscription). This skill provides a complete pipeline for working with HWP/HWPX on any OS:

.hwp → [read] → JSON / Markdown / HTML
.hwp → [convert] → .hwpx → [edit] → filled form

Features

Quick start

1. Install

git clone https://github.com/Yoojin-nam/hwp-pipeline.git
cp -r hwp-pipeline ~/.claude/skills/hwp-pipeline
cd ~/.claude/skills/hwp-pipeline
bash setup.sh

2. Use with Claude Code

The skill activates automatically when you mention HWP/HWPX files or Korean document editing. Examples:

• “Convert this HWP to Markdown”
• “Fill in the placeholders in this government form”
• “Extract text from this HWPX file”

3. Use scripts directly

Extract text from HWPX:

python3 scripts/text_extract.py document.hwpx --include-nested

Replace placeholders:

python3 scripts/zip_replace_all.py template.hwpx output.hwpx \
  --replace "{name}=John" "{date}=2026-01-01" --auto-fix-ns

Convert HWP to HWPX:

java -jar java/hwp2hwpx-fat.jar input.hwp output.hwpx

Project structure

hwp-pipeline/
├── SKILL.md              # Claude Code skill definition
├── setup.sh              # One-command dependency installer
├── java/
│   ├── Convert.java      # HWP→HWPX CLI wrapper
│   └── pom.xml           # Maven build with shade plugin (fat JAR)
├── scripts/
│   ├── text_extract.py   # HWPX text extraction CLI
│   ├── zip_replace_all.py # Global placeholder replacement
│   └── fix_namespaces.py # XML namespace normalization
├── references/
│   └── api.md            # python-hwpx API reference
└── examples/
    ├── 01_create_and_save.py
    ├── 02_extract_and_inspect.py
    └── 03_template_replace.py

Acknowledgments

This skill integrates work from:

• hwp2hwpx by neolord0 — HWP to HWPX conversion (Apache 2.0)
• python-hwpx / hwpx-skill by airmang — HWPX editing library and skill (MIT)
• @ohah/hwpjs by ohah — HWP to JSON/Markdown/HTML (MIT)

License

MIT