hwpx

Generate and edit HWPX documents from Markdown with template substitutions.

150|39|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/jkf87/hwpx-skill --skill hwpx-jkf87
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: hwpx
Source: https://github.com/jkf87/hwpx-skill/tree/main
Command: npx skills add https://github.com/jkf87/hwpx-skill --skill hwpx-jkf87

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill requires pyhwp5, olefile, lxml, python-hwpx, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

HWP/HWPX ๋ฌธ์„œ๋ฅผ ์ƒ์„ฑยท๋ณ€ํ™˜ยท์ฝ๊ธฐยทํŽธ์ง‘ํ•˜๋Š” ๋ณต์žกํ•œ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ Claude ์Šคํ‚ฌ๋กœ ํ†ตํ•ฉํ•˜๊ณ  ์ž๋™ํ™”ํ•ฉ๋‹ˆ๋‹ค.

Core Features & Use Cases

  • ์ฝ˜ํ…์ธ ์—์„œ HWPX ๋ฌธ์„œ๋ฅผ ์ƒ์„ฑํ•˜๊ณ  ํ…œํ”Œ๋ฆฟ ์น˜ํ™˜ ๋ฐ ๊ธฐ์กด ๋ฌธ์„œ ํŽธ์ง‘(C/C)๊นŒ์ง€ ๋‹จ์ผ ์›Œํฌํ”Œ๋กœ์šฐ๋กœ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.
  • HWPX์—์„œ ํ…์ŠคํŠธ๋ฅผ ์ถ”์ถœํ•˜๊ณ  ์ด๋ฏธ์ง€ ํฌํ•จ ๋ฌธ์„œ๋ฅผ ๊ตฌ์„ฑํ•˜๋Š” ๋“ฑ ์ผ๋ฐ˜ ์—…๋ฌด๋ฅผ ์ž๋™ํ™”ํ•ฉ๋‹ˆ๋‹ค.
  • ์‹ค๋ฌด ์˜ˆ์‹œ: Markdown ์ž…๋ ฅ์œผ๋กœ HWPX ๋ณด๊ณ ์„œ๋ฅผ ์ž๋™ ์ƒ์„ฑํ•˜๊ณ  ๊ณต๋ฌธ์„œ ๊ทœ์น™์— ๋งž์ถ˜ ์„œ์‹ ์ ์šฉ ๋ฐ ํ…œํ”Œ๋ฆฟ ์น˜ํ™˜์„ ํ•œ ๋ฒˆ์— ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

Quick Start

Convert a Markdown document to HWPX using the md2hwpx workflow and optionally apply a government template.

Frequently Asked Questions about hwpx

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown to HWPX format?โ–ผ

Markdown to HWPX conversion uses the md2hwpx workflow to deterministically assemble section0.xml and header.xml from Markdown input, optionally applying government template substitutions for official documentation formatting.

Can I extract text and embed images in existing HWPX files?โ–ผ

HWPX text extraction and image embedding are fully supported. The workflow automates reading content from existing HWPX documents and constructing new documents with embedded images for research and reporting tasks.

Do I need pyhwp5 and olefile to generate HWP documents?โ–ผ

Generating and transforming HWP/HWPX documents requires the pyhwp5, olefile, lxml, and python-hwpx packages. These dependencies handle OLE container parsing, XML manipulation, and namespace validation for deterministic document assembly.

What is the best way to automate official document formatting with templates?โ–ผ

Automating official document formatting is best achieved through template substitution within the HWPX generation workflow, which replaces placeholders in header.xml and section0.xml to apply government documentation rules deterministically.

Does python-hwpx validate namespaces in generated HWPX files?โ–ผ

python-hwpx validates generated HWPX files using fix_namespaces and verify/validate scripts. This ensures output section0.xml and header.xml conform to required namespace specifications for HWP/HWPX document compatibility.

Why does HWPX document generation fail with namespace errors?โ–ผ

HWPX namespace errors occur when section0.xml or header.xml contain invalid or missing namespace declarations. The workflow's fix_namespaces script corrects these declarations, and validate scripts verify output integrity before finalizing the document.