TypeScript library for reading and writing Korean HWP/HWPX documents.

한글(HWP/HWPX) 문서를 읽고 쓰는 TypeScript 라이브러리.

• 📖 Read HWPX files — tested on 349 real-world documents
• ✍️ Write HWPX files — programmatic document creation with builder API
• 📄 Read HWP 5.x binary files (OLE2/CFB format)
• 🔄 Round-trip preservation — parse → write → identical output
• 📊 Rich content extraction — tables, images, equations, shapes, headers/footers, footnotes
• 📐 Page layout — size, margins, columns, section properties
• 🔤 Full text extraction with per-section support
• 🔁 Format conversion — DOCX ↔ HWPX, HTML export, PDF export
• 👁️ Web viewer — React component for rendering HWPX documents
• ✏️ Web editor — ProseMirror-based WYSIWYG editor (in progress)

npm install @handoc/hwpx-parser @handoc/hwpx-writer

import { HanDoc } from '@handoc/hwpx-parser';
import fs from 'fs';

const doc = await HanDoc.open(new Uint8Array(fs.readFileSync('document.hwpx')));

// Extract all text
console.log(doc.extractText());

// Access structured data
for (const section of doc.sections) {
  console.log(section);
}

// Images, tables, metadata
console.log(doc.metadata);   // { title, creator, language }
console.log(doc.images);     // [{ path, data, contentType }, ...]

import { readHwp, extractTextFromHwp } from '@handoc/hwp-reader';
import fs from 'fs';

const buf = new Uint8Array(fs.readFileSync('document.hwp'));
const text = extractTextFromHwp(buf);
console.log(text);

import { HwpxBuilder } from '@handoc/hwpx-writer';
import fs from 'fs';

const bytes = HwpxBuilder.create()
  .addParagraph('Hello World', { bold: true, fontSize: 20 })
  .addTable([['Name', 'Score'], ['Alice', '95']])
  .addParagraph('Second paragraph')
  .build();

fs.writeFileSync('output.hwpx', bytes);

import { HanDoc } from '@handoc/hwpx-parser';
import { writeDOCX } from '@handoc/docx-writer';
import fs from 'fs';

const doc = await HanDoc.open(new Uint8Array(fs.readFileSync('input.hwpx')));
const docxBuffer = await writeDOCX(doc);
fs.writeFileSync('output.docx', docxBuffer);

This is a monorepo with 12 packages:

• HWPX file parsing (ZIP → parts extraction)
• HWPX header parsing (fonts, styles, paragraph styles)
• HWPX body parsing (text, formatting, tables)
• HWPX file writing (document model → ZIP)
• HwpxBuilder API (programmatic document creation)
• HWP 5.x binary reading (OLE2/CFB format)
• Table parsing (cell merging, borders)
• Image/OLE binary data extraction
• Stats: 349/349 HWPX files parsed successfully, 221/221 HWP files

• HWPX → DOCX conversion
• DOCX → HWPX conversion
• HWPX → HTML conversion (standalone HTML)
• CLI tool (convert, to-html commands)
• Stats: 587 lines (docx-writer), 1,456 lines (docx-reader), 120 tests

• HWPX → HTML → PDF (Puppeteer/Playwright)
• Table, image, formatting HTML rendering
• Base64 image embedding, CSS styling
• CLI commands: handoc to-html, handoc to-pdf
• Stats: 378 lines (pdf-export), real HWP file tests passed

• React component for HWPX rendering
• Responsive layout, mobile support
• Table rendering, image display
• Section-based rendering
• Stats: 235 lines, 13 tests

• ProseMirror-based editor setup
• HWPX → ProseMirror schema conversion
• Basic editing (text, bold, italic, headings)
• Table editing
• Image insertion
• Full WYSIWYG features
• Stats: 271 lines, 21 tests

• Packages: 12 (monorepo with Turborepo + pnpm)
• Source Code: 7,809 lines (TypeScript)
• Tests: 469 passed
• Real Documents: 570/570 parsed (349 HWPX + 221 HWP)
• Build: 12/12 packages ✅

pnpm install
pnpm build      # Build all packages
pnpm test       # Run all tests
pnpm typecheck  # Type check

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

MIT © MUIN Company

본 제품은 한글과컴퓨터의 HWP 문서 파일(.hwp) 공개 문서를 참고하여 개발하였습니다.