kordoc

chrisryugj/kordoc is an open-source project by chrisryugj: 모두 파싱해버리겠다 — HWP·HWPX·PDF·Office 문서를 Markdown으로. 양식 자동 채우기와 신구대조를 갖춘 CLI·MCP 서버 | Convert Korean documents (HWP, HWPX, PDF, Office) to Markdown — CLI and MCP server with form filling and diff. Indexed here so it can be found — not resold.

It is free. Get it from the upstream repository: https://github.com/chrisryugj/kordoc

From the project's own README (excerpt, reproduced for discovery under its MIT license):

kordoc

모두 파싱해버리겠다.

> 대한민국에서 둘째가라면 서러울 문서지옥. 거기서 7년 버틴 공무원이 만들었습니다.

HWP 3.x·5.x, HWPX, HWPML, PDF, XLS·XLSX, DOCX, PPTX, PNG·JPG·WebP를 Markdown과 구조화 데이터로 변환합니다. 라이브러리·CLI·MCP 서버로 사용할 수 있습니다.

English · 상세 사용법 · 벤치마크 · 변경 이력 • 📊 PDF 공개 벤치 종합 0.963 — opendataloader-bench 200문서. 공개 12개 파서 비교 1위(2026-09-29 기록). 측정 조건 • 🇰🇷 한국 공문서 표 구조 100% — 원본 HWPX 2,424문서의 보이는 표 10,342개 전부 구조 일치. 4.21.22 검증

쓸모 있었다면 GitHub ⭐ 하나 눌러주세요. 다른 사람이 이 도구를 찾는 데 도움이 됩니다.

▶ 클릭하면 유튜브에서 재생됩니다.

새 영상: kordoc 공개벤치 1위 마크 · 2026-09-27 · 1분 31초

설치

Node.js 20 이상 · macOS / Linux / Windows

CLI는 설치 없이 npx kordoc으로 실행할 수 있습니다. PDF·OCR 의존성은 기본 설치되며, --omit=optional로 제외하면 해당 기능이 제한됩니다.

AI 에이전트에 연결

Claude Desktop·Claude Code·Cursor·Codex 등 설치된 클라이언트에 MCP를 등록합니다. 클라이언트를 재시작하면 파싱·비교·생성·렌더 등 17개 도구를 사용할 수 있습니다.

Claude Code 플러그인:

수동 MCP 등록과 설치 문제 해결

빠른 시작

CLI

--jobs는 파일 단위 병렬 변환이며 메모리 사용도 늘어납니다. 병렬 변환 안내

보고서·계획서·개조식·서울방침은 # 제목 바로 뒤 인용문(> …하고자 함)이 요약 상자가 됩니다(개조식은 표지가 있을 때(기본) 본문 첫 쪽 제목 상자 아래 — cover:false 면 첫 # 이 장 머리라 인용문은 ※ 참고). 보고 목적 한 문장(쉼표 허용) 3줄 이내로 쓰고, 넘거나 두 문장 이상이면 경고합니다. 업무보고는 > ▪ … 인용문이 자리와 관계없이 성과 요약 상자가 됩니다.

JavaScript / TypeScript

파싱 옵션·API·양식·렌더 예제

주요 기능

작업 기능 --- --- 읽기 문서 → Markdown·IR·쪽별 본문·RAG 청크, 로컬 OCR 비교·편집 블록·셀 단위 비교, HWPX·HWP 서식 보존 패치 작성 Markdown → HWPX, 공문서 프리셋, 표·수식·차트 양식 필드·누름틀 채우기, 표준 기안문 2종, 도장 날인 검토 HWPX·HWP 미리보기·영역 추출, 구조·표기법 검사, 개인정보 마스킹

서식 보존 패치용 Markdown은 --keep-layout-tables로 추출합니다. 적용하지 못한 편집은 건너뛴 사유로 보고합니다. CLI·API 상세

검증 결과

4.21.22 · 2026-10-11 배포 검증. 고정 코퍼스와 참조 기준으로 측정한 결과입니다.

대상 규모 결과 --- --- --- HWPX 2,424문서 · 10,342표 표 구조 일치 10,342/10,342 · 100% HWP 5.x ↔ HWPX 1,130쌍 · 4,315표 짝 문서의 표 구조 일치 100% PDF 글 744쌍 글자 재현율 99.85% · 정확도 99.67% · 읽기 순서 99.23% · 어절 F1 99.02% PDF 표 708쌍 · 2,331표 표 탐지 99.83% · 구조 일치…