PubAX › kordoc › HWP 파일을 마크다운으로 변환하기

HWP 파일을 마크다운으로 변환하기

한컴오피스를 설치하지 않아도 됩니다. kordoc이 HWP 파일을 직접 읽어서 마크다운으로 저장합니다. 병합된 표 칸도 같은 짜임의 표로 옮깁니다.

1. 준비

Node.js 20 이상만 있으면 됩니다. macOS·Linux·Windows에서 같은 명령으로 동작합니다.

2. 파일 하나 변환

복사npx kordoc 문서.hwp -o 문서.md

HWPX·PDF·DOCX·XLSX·PPTX도 같은 명령입니다. 확장자가 아니라 파일 머리를 읽어서 형식을 판단합니다.

3. 여러 파일 한꺼번에

복사npx kordoc *.hwpx -d ./결과
npx kordoc *.pdf --jobs 4 -d ./결과

--jobs는 파일을 여러 개 동시에 변환합니다. 동시에 많이 돌릴수록 메모리를 더 씁니다.

표는 이렇게 나옵니다

법령 별표 HWP 파일을 변환한 실제 결과 일부입니다.

복사■ 도시 및 주거환경정비법 시행령 [별표 5의2] <개정 2024. 7. 23.>

| 위반행위 | 근거 법조문 | 과징금 금액 |
| --- | --- | --- |
| 가. 건설업자 또는 등록사업자가 법 제132조제1항을 위반한 경우 | 법 제113조의2제1항제1호 |  |
| 1) … 가액의 합이 3천만원 이상인 경우 |  | 공사비의<br>100분의 20 |

병합 칸이 있는 표는 기본으로 HTML 표(rowspan·colspan)로 나옵니다. HTML 없이 파이프 표만 원하면 --table-format gfm을 붙입니다.

자주 쓰는 옵션

자주 묻는 질문

한컴오피스가 있어야 하나요? 아니요. 파일 구조를 직접 읽습니다.

옛날 HWP 3.0 파일도 되나요? HWP 3.x와 5.x 모두 읽습니다.

프로그램 안에서 쓰려면? npm install kordoc 뒤 parse("문서.hwp")를 부릅니다. 파이썬은 Python SDK 안내를 보세요.