read-hwp

Convert HWP/HWPX/HWPML documents into Markdown and structured JSON.

8|1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/mouseco/k-gov-skills --skill read-hwp
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: read-hwp
Source: https://github.com/mouseco/k-gov-skills/tree/main/skills/read-hwp
Command: npx skills add https://github.com/mouseco/k-gov-skills --skill read-hwp

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill requires kordoc, pdfjs-dist.

What problem does it solve?

Public-sector HWP/HWPX documents are difficult to read and reuse in AI workflows, so converting them manually into structured, reviewable text is time-consuming and error-prone.

Core Features & Use Cases

  • HWP/HWPX/HWPML โ†’ Markdown or JSON: Converts documents into AI-friendly Markdown and/or structured JSON including document blocks and metadata.
  • Diff and comparison: Compares two document versions to highlight what changed.
  • Form field extraction and reverse conversion: Extracts HWPX form fields from parsed content and can convert Markdown back into HWPX for submission-ready output.
  • Batch and watch processing: Supports converting single files, page ranges, folders, and glob patterns.

Quick Start

Ask the agent to convert your document file to Markdown using this skill and save the result to an output path.

Frequently Asked Questions about read-hwp

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

FAQPage Schema
How do I convert HWP files to Markdown for text processing?โ–ผ

Converting HWP files to Markdown involves parsing the document structure and extracting text blocks into a readable format. This skill uses kordoc for read-only parsing to transform HWP, HWPX, and HWPML files into AI-friendly Markdown or structured JSON.

Can I extract form fields from HWPX documents automatically?โ–ผ

Yes, you can extract form fields from HWPX documents automatically. The skill includes an optional extractFormFields feature that identifies and pulls structured form field data from parsed HWPX content for downstream automation and review.

What is the best way to compare two versions of an HWP document?โ–ผ

The best way to compare HWP document versions is by parsing both files into structured JSON or Markdown and running a diff. This skill supports document comparison to highlight changes between two versions of HWP or HWPX files.

Does HWP to Markdown conversion require Node.js to run?โ–ผ

Yes, HWP to Markdown conversion requires Node.js 18 or higher to run. The skill relies on the kordoc library for read-only parsing and includes pdfjs-dist for any PDF handling needed during the conversion process.

Can I convert Markdown back to HWPX for submission-ready output?โ–ผ

Yes, you can convert Markdown back to HWPX for submission-ready output. The skill provides an optional markdownToHwpx function that reconstructs parsed Markdown content into HWPX format suitable for public-sector distribution.

How do I batch convert multiple HWP files in a folder?โ–ผ

Batch converting HWP files in a folder is supported through glob patterns and watch processing. You can convert single files, specific page ranges, or entire folders of HWP and HWPX documents into Markdown or JSON simultaneously.