kordoc-korean-document-parser — Claude Code skill: HWP and HWPX

What kordoc-korean-document-parser does

Under the hood it is the kordoc library — a TypeScript package plus a CLI. It reads the proprietary HWP binary format, pulls out tables, recognises form fields, diffs two revisions of a document and can generate HWPX back from Markdown. Format detection runs on magic bytes, and there are dedicated parsers: parseHwp, parseHwpx, parsePdf.

Three ways in. The CLI: npx kordoc document.hwpx prints to stdout, -o writes a file, --format json returns blocks with metadata, and watch converts new files as they land in a folder. The programmatic API: parse hands back markdown, blocks, metadata, outline and warnings. Or run it as the kordoc-mcp MCP server, which exposes parse_document, compare_documents, parse_form and more.

PDF support needs pdfjs-dist installed separately — skip it and PDF parsing simply fails. Scanned pages go through a pluggable OCR: you pass your own async function in the parse options, there is no built-in engine. Encrypted files and ZIP bombs come back as an error code instead of an empty result, which is what you want when a batch job runs unattended.