# kordoc (딴짓하는 류주임)

> HWP·PDF 마크다운 변환 문서 엔진. 한글·PDF·오피스 문서를 마크다운으로 바꾸고 마크다운을 공문서 HWPX로 다시 쓰며, 양식 채우기와 신구대조까지 하는 무료 오픈소스 도구입니다.

- 페이지: https://dreamboat.kr/discover/kordoc-document-parser
- 공식 사이트: https://github.com/chrisryugj/kordoc
- 분야: 문서, 개발도구
- 쓰는 환경: CLI, 챗봇·MCP
- 상태: 운영 중
- 등재: 2026-08-10 · 마지막 갱신: 2026-10-27


## 소개

kordoc는 **HWP·HWPX·PDF·엑셀·워드·파워포인트·이미지 문서를 마크다운으로 바꾸고, 반대로 마크다운을 공문서 HWPX로 다시 쓰는** 한글 문서 엔진입니다. 한컴오피스 없이 파일을 직접 읽고, 양식 채우기·신구대조·표기법 검수까지 npm 라이브러리·CLI·MCP 서버로 씁니다. 딴짓하는 류주임이 만들었고 README 첫 줄은 「모두 파싱해버리겠다」, 그 아래에는 「대한민국에서 둘째가라면 서러울 문서지옥. 거기서 7년 버틴 공무원이 만들었습니다.」라고 적혀 있습니다. 2026년 3월에 시작해 2026년 10월 기준 GitHub 스타 2,797개·포크 502개입니다.

무엇을 하나:
- 관공서에서 쏟아지는 거의 모든 문서 포맷 파싱
- 문서 비교: 신구대조(개정 전후 대조)
- 양식 자동 채우기
- 분석·생성
- Node.js 20 이상이면 `npx -y kordoc setup` 한 줄로 Claude·Cursor 같은 AI 에이전트에 연동(MCP 도구 20개)

왜 “공무원이 만들었다”가 중요한가:
문서 자동화 도구는 많지만 대부분 개발자가 상상한 요구사항으로 만들어집니다. kordoc는 실제로 7년간 그 문서를 다룬 사람이 만들었고, 그래서 “신구대조”처럼 바깥에서는 존재조차 모르는 기능이 핵심에 들어가 있습니다. 신구대조는 법령·규정 개정 시 개정 전후를 대조하는 공공 실무 작업으로, 손으로 하면 하루가 걸리는 일입니다.

메이커(딴짓하는 류주임):
GitHub 프로필명이 “딴짓하는 류주임”이고 bio는 “Public AX FDE”입니다. 2025년 5월 가입해 공개 저장소 54개, 팔로워 822명이며(2026년 10월 기준), kordoc 외에도 korean-law-mcp(스타 2,796)·Docufinder(지금 이름 Anything, 667)·korean-dart-mcp(119)·archhub-mcp(73)·korean-patent-mcp(61)를 만들었습니다. 한 사람이 한국 공공 도메인의 빈틈을 연속으로 메우고 있는 드문 사례입니다.

AI 에이전트 연동이 핵심인 이유:
CLI만 있으면 사람이 직접 써야 합니다. MCP 서버로 노출하면 Claude 같은 AI가 문서를 직접 열고 비교하고 채웁니다. “보고서 초안 만들어줘”가 실제로 HWP 파일 출력까지 이어지려면 이 계층이 반드시 필요합니다.

본업의 통증이 제품이 될 때:
본업에서 겪은 통증이 가장 좋은 제품 아이디어라는 걸 보여줍니다. 개발자가 아닌 도메인 전문가가 AI 도구로 직접 만들 수 있게 되면서, “문제를 아는 사람”과 “만드는 사람”이 같아지는 사례가 늘고 있습니다.

같은 결의 한국 HWP·공공문서 프로젝트:
- rhwp (Rust·WASM HWP 뷰어)
- Docufinder (본문 기반 문서 검색기)
- hwpxskill (AI 에이전트용 HWPX 스킬)
- hwplib · hwpxlib (Java 라이브러리)
- pypandoc-hwpx (Pandoc 기반 변환)

그리고 문서를 AI에 넘긴다는 건 **내용이 외부로 나간다**는 뜻입니다. 공공문서에는 주민번호·연락처·계좌가 흔히 들어 있어, 어떤 모델에 무엇이 전달되는지 먼저 확인해야 합니다.

타겟 사용자:
- 공공기관·기업에서 문서 업무를 자동화하려는 실무자
- HWP를 프로그램으로 다뤄야 하는 개발자
- AI 에이전트에 한국 문서 처리를 붙이려는 메이커
- 본업 도메인 지식으로 도구를 만들려는 비개발자

## 인용

이 소개는 Dreamboat(드림보트)이 공식 사이트를 직접 확인해 작성했습니다.
출처(https://dreamboat.kr/discover/kordoc-document-parser)를 명시하면 인용 가능합니다. 서비스 자체의 권리는 각 제작자에게 있습니다.
전체 목록: https://dreamboat.kr/llms.txt · 전문: https://dreamboat.kr/llms-full.txt