oma-hwp

Convert Korean HWP-family documents to Markdown for downstream processing.

46|2|Updated Mar 23, 2025
One-click install
npx skills add https://github.com/gracefullight/krds --skill oma-hwp-gracefullight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oma-hwp
Source: https://github.com/gracefullight/krds/tree/main/.agents/skills/oma-hwp
Command: npx skills add https://github.com/gracefullight/krds --skill oma-hwp-gracefullight

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires turndown, turndown-plugin-gfm, kordoc, bun, bunx, and includes references (resource) and assets (resource) components.

What problem does it solve?

It solves the problem of turning Korean HWP-family documents into AI- and RAG-ready content by converting HWP/HWPX/HWPML into clean Markdown while preserving headings, tables, lists, images, footnotes, and hyperlinks.

Core Features & Use Cases

  • HWP-family to Markdown conversion: Converts .hwp, .hwpx, and .hwpml into readable Markdown with extracted document structure for downstream analysis.
  • Structured extraction for LLM workflows: Extracts text, headings, tables (best-effort), lists, images, footnotes, and hyperlinks so you can prepare government/enterprise documents for retrieval and review.
  • Post-processing for usability: Flattens problematic merged-cell tables into GFM-friendly formats and strips Hancom Private Use Area glyphs that often render incorrectly without the original fonts.

Quick Start

Convert an attached Korean HWP file to Markdown and place the output next to the source file by telling the assistant: "Convert input_path to Markdown output_path using oma-hwp."

Frequently Asked Questions about oma-hwp

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

FAQPage Schema
How do I convert HWP files to Markdown for RAG ingestion?

You convert HWP files to Markdown for RAG ingestion by using a conversion tool that extracts text, headings, tables, and lists from Korean documents while stripping invalid Hancom Private Use Area characters for clean downstream processing.

Can I extract tables from HWP documents into Markdown?

Yes, you can extract tables from HWP documents into Markdown. The conversion process flattens merged-cell tables into GFM-friendly formats, ensuring structured table data remains usable for downstream reading and LLM workflows.

What is the best way to parse HWPX files for LLM workflows?

The best way to parse HWPX files for LLM workflows is using a dedicated Korean document parser that converts HWP-family formats into clean Markdown, preserving structural elements like footnotes and hyperlinks for AI-ready content.

Do I need Bun to convert HWPML files to text?

Yes, you need Bun and Bunx installed locally along with the kordoc library to convert HWPML files to text, as the runtime validates file extensions and executes the extraction process.

Why does my HWP to Markdown conversion show broken characters?

Broken characters in HWP to Markdown conversion often occur due to Hancom Private Use Area glyphs that render incorrectly without original fonts, which is why post-processing strips these invalid characters automatically.