한국 정부 공문서의 모든 형식(HWP/HWPX/PDF/DOCX/XLSX)을 마크다운으로 변환·편집·생성하는 문서 처리 엔진
중간맛 분석
스택: TypeScript + Node.js 18+, + 라이브러리 + MCP(Claude/Cursor 연동) 난이도: 2/5 바로 쓸 수 있나? 네, npx -y kordoc setup 한 줄로 설치되고, Claude Desktop/Cursor 같은 AI 에디터에 자동으로 연동됩니다. 데모: 325개 실제 정부 문서로 검증한 99.99% 정확도 + 표 구조 100% 일치율.
이런 레포예요
이럴 때 쓰면 좋아요
- 정부 공문서를 AI가 자동으로 읽고 분석·작성하기
- 한글 문서와 PDF를 마크다운으로 변환해 버전 관리 및 협업하기
- 복잡한 표 구조가 있는 공문서를 무손실로 편집하고 원본 서식 보존하기
핵심 기능
대안 대비 차별점
한국 정부 공문서 처리에 최적화된 유일한 오픈소스 도구로, 한컴의 독점 형식(HWP5 바이너리)과 공문서 서식을 기본 지원하며 Pandoc·LibreOffice 같은 범용 도구가 할 수 없는 표 구조 보존과 무손실 편집을 제공합니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Node.js 18 이상
바로 차려먹기Node.js (npm)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/chrisryugj/kordoc.git && cd kordoc && npm install && npm run dev
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- Node.js 18+ 설치 확인
node --version
- AI 에이전트(Claude/Cursor 등) 연동 자동 설치
npx -y kordoc setup
대화형 마법사가 사용 중인 AI 클라이언트를 감지해 설정을 자동 패치하고 재시작하면 10개 문서 도구가 활성화됩니다.
- CLI로 단독 사용 (설치 불필요)
npx -y kordoc 파일명.hwpx
- 문서 편집 및 패치 (마크다운 편집 후 원본 반영)
npx -y kordoc 원본.hwpx > 편집본.md
# 편집본.md를 수정한 후:
npx -y kordoc patch 원본.hwpx 편집본.md -o 결과.hwpx
- 마크다운을 HWPX 공문서로 생성
npx -y kordoc generate doc.md -o out.hwpx --preset 보고서
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try chrisryugj/kordoc
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
「MCP·클로드 연동」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/chrisryugj/kordoc)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기