kordoc
한컴오피스 없이 HWP·HWPX·PDF, 엑셀·워드·파워포인트, 이미지 파일을 마크다운과 구조화 데이터로 바꿉니다. 마크다운으로 HWPX 공문서를 만들고, 양식을 채우고, 두 문서를 비교합니다.
한 줄로 변환
Node.js 20 이상이 있으면 설치 없이 바로 됩니다.
npx kordoc 문서.hwp -o 문서.md
하는 일
| 작업 | 기능 |
|---|---|
| 읽기 | 문서 → Markdown·JSON·쪽별 본문·RAG 청크, 스캔본은 로컬 OCR |
| 비교·편집 | 블록·셀 단위 비교, 원본 서식을 지킨 HWPX·HWP 수정 |
| 작성 | Markdown → HWPX, 보고서·계획서 등 공문서 프리셋, 표·수식·차트 |
| 양식 | 누름틀·필드 채우기, 표준 기안문 2종, 도장 날인 |
| 검수 | 공문서 표기법·공공언어 검사, 예산 산출근거 검산 |
쓰는 방법
- HWP 파일을 마크다운으로 변환하기: 터미널 명령 하나로 변환, 여러 파일 한꺼번에
- Claude·Cursor·VS Code에서 HWP 파일 읽게 하기: MCP 서버 등록
- 파이썬에서 HWP 파일 읽기: Python SDK
- 마크다운으로 한글(HWPX) 보고서 만들기: 공문서 프리셋, 기안문 양식
폐쇄망
KORDOC_OFFLINE=1을 켜면 외부 통신을 모두 막습니다. OCR도 API 키 없이 로컬 CPU에서 돌아갑니다. 오프라인 설치 번들은 폐쇄망 설치 문서에 있습니다.
만든 사람
광진구청에서 7년 동안 HWP 파일을 다룬 지방공무원이 만들었습니다. 정확도 측정 결과와 재현 방법은 벤치마크 문서에 있습니다.
kordoc는 MIT 오픈소스입니다. 쓸모 있었다면 GitHub에서 ⭐를 눌러 주세요. 다른 사람이 이 도구를 찾는 데 도움이 됩니다.
GitHub에서 보기