用途：将韩文 HWP 系列文档（.hwp、.hwpx、.hwpml）转换为可读的 Markdown 或结构化 JSON，保留文档结构，便于 LLM 上下文、RAG、政府公文审阅或企业文档处理。
主要能力：支持文本、标题、表格、嵌套表格、列表、图片、脚注和超链接的提取；输出格式可选 markdown（默认）、json（结构化 AST）或 chunks（面向 RAG 的结构化分块 JSON）；支持页面或章节范围、指定输出目录。默认对 Markdown 进行表格扁平化为 GFM 并移除私用区字形。
使用方式：输入 .hwp、.hwpx 或 .hwpml 文件路径，可选指定输出路径或目录、格式、页码范围、kordoc 版本。核心命令：bunx kordoc@latest "{input_path}" -o "{output_path}"；批量转换用 -d 指定输出目录。新克隆后需在 resources/ 目录运行 bun install。
适用场景：韩文 HWP 转 Markdown、为 LLM 或 RAG 准备韩文政府/企业文档、从 HWP 提取结构化内容。
限制：不处理 PDF、XLSX、DOCX（PDF 用 oma-pdf）；不支持生成或编辑 HWP 文档；纯文本文件直接用 Read 工具。需要 bun/bunx 运行时。加密或 DRM 锁定文档可能受限；空输出可能为扫描图像，建议外部 OCR；复杂合并表格可能降级为扁平 Markdown 或 HTML 回退。