도구별 실전 가이드 · 공식 정보 확인 2026-08-20

kordoc MIT 오픈소스 조건과 시작 절차

작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: CLI, Self-hosted · 페이지 갱신: · 운영·편집 기준

HWP·HWPX·PDF·Office 문서를 Markdown으로 바꾸고 양식 채움·신구대조를 수행하는 한국 문서용 Markdown 변환·양식 처리 CLI와 MCP 서버입니다.

HWP·HWPX·PDF·Office 문서를 Markdown으로 바꾸고 양식 채움·신구대조를 수행하는 한국 문서용 Markdown 변환·양식 처리 CLI와 MCP 서버입니다. kordoc의 첫 실전 과제는 “개정 전후 HWP 규정 두 파일을 변환해 변경 조항 비교하기”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.

이럴 때 맞습니다

  • “표와 각주가 포함된 구 규정 HWP와 개정 규정 HWPX” 같은 입력으로 kordoc의 핵심 기능을 시험하려는 사람
  • 조항 번호·표 셀·삭제와 추가 표시가 원본 두 문서와 일치하는지 기준으로 kordoc 결과를 직접 검수할 수 있는 경우
  • CLI·Self-hosted 환경에서 MIT 코드를 직접 설치·관리하려는 작업

이럴 때는 멈추세요

  • 한국 문서용 Markdown 변환·양식 처리 CLI와 MCP 서버 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
  • 다음 위험을 사람이 확인할 수 없는 작업: 복잡한 한글 문서의 병합 셀·각주·수식이 변환 중 누락되어 잘못된 차이를 만드는 문제.

참고 시작점

팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.

구·신 규정을 각각 Markdown으로 푼다

두 한글 문서가 조항 구조를 보존한 비교 가능한 텍스트가 된다.

참고 시작점: 구 HWP와 개정 HWPX를 각각 Markdown으로 변환하되 조항 번호와 표 구조를 지켜 줘.

  1. kordoc CLI에 구 규정 HWP와 개정 규정 HWPX를 별도 입력으로 준다.
  2. PDF·Office 자동 감지 결과가 아니라 실제 HWP·HWPX 파서를 사용했는지 로그를 확인한다.
  3. 각 변환본에서 조항 번호·각주·병합 셀을 원문 페이지와 표본 대조한다.

신구대조를 조항 단위로 만든다

추가·삭제·수정된 규정 문장이 조항 번호와 함께 드러난다.

참고 시작점: 두 변환본을 조항 번호로 맞추고 삭제, 추가, 표현 변경을 구분해 줘.

  1. kordoc의 diff 기능에 두 Markdown 결과의 순서를 명시한다.
  2. 표 안 숫자와 본문 문장을 같은 변경으로 합치지 않고 셀 단위로 본다.
  3. 삭제와 추가 표시가 뒤바뀌지 않았는지 대표 조항 세 개를 원문과 대조한다.

양식 처리 범위를 검증한다

후속 자동 채움에 써도 되는 필드와 수동 검토 필드가 구분된다.

참고 시작점: 변환이 안정된 일반 필드와 병합 셀·수식처럼 수동 확인할 필드를 목록으로 나눠 줘.

  1. form filling에 쓰기 전 표 셀과 문서 양식의 필드 이름을 확인한다.
  2. MCP 서버에는 검증된 Markdown 사본만 제공하고 원본 규정 폴더는 읽기 전용으로 둔다.
  3. 누락된 각주나 수식이 하나라도 있으면 자동 신구대조 결과를 확정본으로 표시하지 않는다.

무료 조건과 주의점

MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도

MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도

MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.

복잡한 한글 문서의 병합 셀·각주·수식이 변환 중 누락되어 잘못된 차이를 만드는 문제.

공식 근거와 확인일

kordoc 가이드의 주장별 공식 출처
확인 항목확인한 내용공식 출처·확인일
제품 정보HWP·HWPX·PDF·Office 문서를 Markdown으로 바꾸고 양식 채움·신구대조를 수행하는 한국 문서용 Markdown 변환·양식 처리 CLI와 MCP 서버입니다.kordoc 공식 사이트
무료 조건MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도공식 무료 정책·요금 안내
공식 코드 라이선스오픈소스 코드의 사용·수정·재배포 조건공식 코드 라이선스
공식 제품 페이지HWP·HWPX·PDF·Office 문서를 Markdown으로 바꾸고 양식 채움·신구대조를 수행하는 한국 문서용 Markdown 변환·양식 처리 CLI와 MCP 서버입니다.공식 제품 페이지