ai-screams/hwpforge

This page was translated automatically. Technical details may differ from the original. View the original

20 stars 5 forks Quality 82 Trend 30Apache-2.0

Rust library for programmatic control of Korean HWPX documents — Markdown→HWPX conversion, JSON round-trip editing, MCP server for AI agents 🔥

Overview

Hancom Korean File Reading, Writing, and Conversion This product was developed with reference to Hancom's HWP document file (.hwp) public documentation. HwpForge is a pure Rust library designed for handling HWPX documents (ZIP + XML, KS X 6101). It supports the latest format of Hancom Hangul, the most widely used word processor in Korea. - : Based on OWPML national standard (KS X 6101), ZIP + XML container - : Legacy binary format. Currently, CLI-centric read/check/reoutput paths are provided (convert-hwp5, audit-hwp5, census-hwp5) - Style set can be selected as HancomStyleSet enum (default: Modern) 🔥 — AI-friendly Markdown and the official Korean document format (HWPX) naturally bridge the two worlds. Content created by LLMs using Markdown is compiled 📜 into official document standard HWPX, while existing HWPX documents can ⚒️ be extracted in a structure that AI can easily read. - — 4-section demo document generated with HwpForge API (open in Korean) - — ai-scream.ai/HwpForge: Getting Started, User Guide (Python· Markdown conversion, style templates, etc.), API references - — Convert existing Korean documents (.hwpx) to Markdown so LLMs can immediately understand them - — Decode/encode HWPX files without loss (lossless roundtrip) - — Bidirectional conversion between GFM Markdown and HWPX (read + write) - — Reusable style definitions like Figma Design Token (font, size, color) - — branded index, typestate validation, zero unsafe code By installing the CLI tool hwpforge (Hammer), you can create and edit documents directly from the terminal.

Overview (machine translated)

Control Korean (HWP/HWPX) documents programmatically in Rust

Hancom Korean file reading, writing, and conversion

This product was developed with reference to Hancom’s HWP documentation (.hwp) public documentation.

What is HwpForge?

HwpForge is an open-source pure Rust library designed for handling HWPX documents (ZIP + XML, KS X 6101). It supports the latest format of Hancom Hangul, the most widely used word processor in Korea.

Supported Version

Korean Version	Format	Reading	Writing	Style Set
Hangul 2014 ~ 2020	HWPX (.hwpx)	✅	✅	Classic (18 styles)
Hangul 2022 ~ 2024	HWPX (.hwpx)	✅	✅	Modern (22 styles, default)
Hangul 2025+	HWPX (.hwpx)	✅	✅	Latest (23 styles)
Hangul 97 ~ 2010	HWP5 (.hwp)	✅	—	—

HWPX: Based on OWPML national standard (KS X 6101), ZIP + XML container
HWP5: Outdated binary format. Currently provides CLI-centric read/check/reoutput paths (convert-hwp5, audit-hwp5, census-hwp5)
Style sets can be selected as HancomStyleSet enum (default: Modern)

LLM-first Design 🔥 — AI-friendly Markdown and the official Korean document format (HWPX) seamlessly connect the two worlds. Content created by LLMs in Markdown is compiled 📜 into official document standard HWPX, while existing HWPX documents can ⚒️ be extracted in a structure that AI can easily read.

** 📄 ** Download the complete HWPX guide — A 4-section demo document generated with the HwpForge API (open in Korean)
** 📚 Documentation Site** — ai-scream.

This page was translated automatically. Technical details may differ from the original.

Install

npx -y @hwpforge/mcp

New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "hwpforge": {
      "command": "npx",
      "args": ["-y", "@hwpforge/mcp"]
    }
  }
}