HWP → MD 편집기
HWP, DOCX, DOC, PDF 문서를 Markdown으로 바꿔서 편집하고, MD / DOCX / DOC / PDF로 저장하는 Next.js 웹 앱입니다.
작업 이력은 docs/HISTORY.md, 프로그램 구조는 docs/PROJECT_STRUCTURE.md에 정리되어 있습니다.
실행 방법
npm install # 처음 한 번만
npm run dev # 개발 서버 실행 → http://localhost:3000
npm test # samples 폴더의 .hwp / .docx / .doc를 .md로 변환해 보기
기능
- 열기:
.hwp(HWP 5.0), .docx, .doc, .pdf, .md 파일을 Markdown으로 변환
- 저장: Markdown(.md), Word(.docx), Word 97-2003(.doc), PDF 중 선택 (Ctrl+S)
- 서식 버튼: 제목, 굵게, 기울임, 목록, 링크, 표
- 화면 모드: 편집 / 나란히 / 미리보기
- 일괄 MD 변환: 여러 파일을 골라(또는 여러 개를 끌어다 놓아) 한 번에 Markdown으로 바꾸고 ZIP 하나로 저장. 실패한 파일은 이유를 보여주고 나머지는 계속 변환
- 파일을 화면에 끌어다 놓아서 열기
- 브라우저에 자동 저장
- 변환은 브라우저 안에서만 일어나서 파일이 서버로 전송되지 않음
열기: 형식별 변환 범위
| 형식 | 가져오는 내용 | 참고 |
|---|
| HWP 5.0 | 문단, 제목("개요 1~6" 스타일), 표, 그림 위치 | HWP 3.0/97, HWPX, 암호·배포용 문서는 미지원 |
| DOCX | 문단, 제목, 굵게/기울임, 목록, 표, 링크, 그림 위치 | |
| DOC (Word 97~2003) | 문단, 표, 필드 결과 | 제목 스타일과 글자 서식은 미지원, Word 95 이하 미지원 |
| PDF | 글자, 문단, 목록 | 표 구조는 글자로 이어짐, 스캔한 이미지 PDF는 미지원 |
그림은 모든 형식에서 *(그림)* 표시만 남깁니다.
저장: 형식별 방식
| 형식 | 방식 |
|---|
| MD | 편집 중인 글 그대로 |
| DOCX | 제목, 굵게/기울임, 목록, 표, 링크, 인용문, 코드를 Word 서식으로 변환 |
| DOC | Word가 열 수 있는 HTML 기반 .doc 파일 (Word에서 "형식이 다르다"는 안내가 나오면 "예"를 누르세요) |
| PDF | 브라우저 인쇄 창이 열리면 대상을 **"PDF로 저장"**으로 선택 (한글 글꼴이 깨지지 않고 글자 선택 가능) |
서식 유지 변환 (변환 서버)
편집기의 변환은 Markdown을 거치기 때문에 글꼴, 색, 정렬 같은 서식이 사라집니다.
원본 모양 그대로 HWP → PDF/DOCX 등으로 바꾸려면 변환 서버(LibreOffice + H2Orestart)를 함께 배포하세요.
Vercel 환경 변수 NEXT_PUBLIC_CONVERT_API_URL에 서버 주소를 넣으면 도구 모음에 서식 유지 변환 버튼이 나타납니다.
폴더 구조
app/
page.tsx 편집기 화면 (React)
FormatConvertDialog.tsx "서식 유지 변환" 창
BatchConvertDialog.tsx "일괄 MD 변환" 창
layout.tsx HTML 기본 틀
globals.css 디자인 (다크 모드, 휴대폰 화면, 인쇄 포함)
lib/hwp/
records.ts HWP 레코드(데이터 조각) 읽기
hwpToMarkdown.ts HWP → Markdown
lib/import/
importFile.ts 확장자에 맞는 변환기 고르기
batchToMarkdown.ts 여러 파일 → Markdown → ZIP (fflate)
docxToMarkdown.ts DOCX → Markdown (mammoth + turndown)
docToMarkdown.ts DOC → Markdown (직접 구현)
pdfToMarkdown.ts PDF → Markdown (pdf.js)
htmlToMarkdown.ts HTML → Markdown
lib/export/
markdownToDocx.ts Markdown → DOCX (docx)
htmlToDoc.ts HTML → DOC
download.ts 파일 내려받기
server/ 서식 유지 변환 서버 (Docker, Render 배포용)
render.yaml Render 배포 설정
scripts/
test-convert.ts 변환 테스트 스크립트
samples/ 테스트용 문서를 넣는 폴더 (저장소에는 미포함)
참고 자료
- 한글과컴퓨터 "한글 문서 파일 형식 5.0" 공개 스펙
- Microsoft "[MS-DOC]: Word (.doc) Binary File Format" 공개 스펙
- hwp.js: JavaScript로 만든 HWP 뷰어
라이선스
MIT
