{
  "markdown": "# claude-hwpx-plugin\n\nA Claude Code plugin for reading, writing, and converting HWP/HWPX documents — the dominant document format in South Korea used by government, education, and enterprise.\n\n한국에서 가장 많이 쓰이는 문서 포맷 HWP/HWPX를 Claude Code에서 읽고, 쓰고, 변환할 수 있게 해주는 플러그인입니다.\n\n---\n\n## Why? | 왜 필요한가?\n\nVirtually all official documents in South Korea are stored in HWP format (Hancom Office Hangul). Government agencies, schools, law firms, and corporations all produce and consume HWP files daily. Converting these documents to usable data has been painful due to the proprietary format and poor tooling around math formula extraction.\n\nThis plugin teaches Claude Code the HWP/HWPX file structure, equation script syntax, and XML schema so it can work with Korean documents natively.\n\n## Installation | 설치\n\n### Option 1: Marketplace (Recommended)\n\n```bash\n# Add marketplace\n/plugin marketplace add hohyon-ryu/claude-hwpx-plugin\n\n# Install plugin\n/plugin install hwpx\n```\n\n### Option 2: settings.json\n\nAdd to `~/.claude/settings.json`:\n\n```json\n{\n  \"extraKnownMarketplaces\": {\n    \"hwpx\": {\n      \"source\": { \"source\": \"github\", \"repo\": \"hohyon-ryu/claude-hwpx-plugin\" }\n    }\n  },\n  \"enabledPlugins\": {\n    \"hwpx@hwpx\": true\n  }\n}\n```\n\n### Option 3: Local Testing\n\n```bash\ngit clone https://github.com/hohyon-ryu/claude-hwpx-plugin.git\nclaude --plugin-dir ./claude-hwpx-plugin\n```\n\n## Quick Reference\n\n| Task | Command |\n|------|---------|\n| Read HWPX → Markdown | `python scripts/reader.py doc.hwpx output.md` |\n| Create HWPX | `python scripts/generator.py out.hwpx \"Title\" \"Body\"` |\n| Validate HWPX | `python scripts/validate.py doc.hwpx` |\n| Read legacy HWP | `pip install pyhwp && hwp5txt doc.hwp` |\n| Use skill | Mention HWP/HWPX/한글 in conversation — skill auto-activates |\n\n## Skill: `/hwpx:hwpx`\n\nA single unified skill that handles all HWP/HWPX operations:\n\n- **Read**: Extract text, equations (→ LaTeX), images, tables from HWPX files\n- **Write**: Generate HWPX with equations, tables, images, multi-column layouts\n- **Convert**: Bidirectional HWPX ↔ Markdown conversion\n- **Edit**: Unpack → edit XML → repack workflow\n\nThe skill auto-activates when you mention HWP, HWPX, 한글, or Hancom documents.\n\n## Scripts\n\n| File | Purpose |\n|------|---------|\n| `scripts/reader.py` | HWPX/HWP5 → Markdown converter |\n| `scripts/generator.py` | Markdown/text → HWPX generator |\n| `scripts/validate.py` | HWPX structure validator |\n\n## Templates\n\n| File | Purpose |\n|------|---------|\n| `templates/base-header.xml` | Font definitions, styles, character properties |\n| `templates/base-section.xml` | Section template with page/column settings |\n| `templates/base-content.hpf` | OPF package manifest |\n| `templates/base-container.xml` | OPF container |\n| `templates/sample-a4.hwpx` | A4 single-column sample |\n| `templates/sample-b4-2col.hwpx` | B4 2-column exam paper sample |\n\n## HWP Equation Syntax\n\nHWP uses its own equation syntax, **not LaTeX**:\n\n```\nLaTeX                    HWP Equation Script\n─────────────────────    ─────────────────────\n\\frac{a}{b}          →  {a} over {b}\n\\sqrt{x}             →  sqrt {x}\n\\text{cm}            →  \"cm\"\n\\overline{AB}        →  rm bar{AB}\n\\triangle ABC        →  rm triangle ABC\n\\cdot                →  cdot (NOT bullet)\n\\to                  →  `->` (backtick spacing)\n```\n\nSee the full conversion table in [SKILL.md](skills/hwpx/SKILL.md).\n\n## Conversion Quality\n\n| Method | Text | Equations | Tables | Images |\n|--------|------|-----------|--------|--------|\n| hwp5txt (pyhwp) | ✅ | ❌ | △ | ❌ |\n| hwp5html → pandoc | ✅ | △ | ✅ | ✅ |\n| **HWPX → reader.py** | ✅ | **✅ LaTeX** | ✅ | ✅ |\n\n**Best quality**: HWP → Save as HWPX in 한글 → `reader.py`\n\n## Use Cases\n\n- **Government**: Convert HWP official documents to Markdown/data\n- **Education**: Auto-generate exam papers in HWPX (B4 2-column)\n- **Legal**: Digitize and structure legal documents\n- **Archive**: Batch-convert HWP documents to Markdown\n\n## Requirements\n\n- Claude Code\n- Python 3.8+ (for scripts)\n- `pyhwp` (optional, for HWP5 binary): `pip install pyhwp`\n- `pandoc` (optional, for HTML→Markdown)\n\n## License\n\nMIT\n\n## Author\n\n**유호현 (Hohyon Ryu)** — [@hohyon-ryu](https://github.com/hohyon-ryu)\n",
  "bytes": 4183,
  "sha": "452ea6a66ab126427e0940bf6e078582affa5bddd12debd0970fa72f032c11cf",
  "repo_slug": "hohyon-ryu/claude-hwpx-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_hohyon_ryu_claude_hwpx_plugin_hwpx_323cc441/readme"
}