---

md2hml - Markdown → HWPML 변환기

표준 Markdown (.md) 파일을 한컴오피스 HWPML (.hml) 형식으로 변환합니다. 표, 코드 블록, 이미지, 다양한 텍스트 서식을 최대한 보존합니다.

이 프로젝트는 Python과 Node.js 스크립트를 모두 제공합니다.

---

주요 기능

• 네이티브 HWP 표 지원 Markdown 표를 한글(HWP)에서 완전히 편집 가능한 네이티브 표로 변환합니다.

• 코드 블록 펜스 코드 블록(```)을 VS Code / GitHub 스타일과 유사한 고정폭 글꼴 + 테두리 박스 형태로 렌더링합니다.

• 이미지 임베딩 로컬 이미지를 Base64로 변환하여 HWPML 파일에 직접 포함합니다.

• 서식 지원

  • 굵게 (Bold)
  • 기울임 (Italic, _Italic_)
  • 인라인 코드 (`code`)

• 목록(List)

  • 순서/비순서 목록
  • 중첩 목록
  • 작업 목록 ([ ], [x])

• 인용문(Blockquote) 들여쓰기 및 스타일이 적용된 인용 블록으로 변환

---

사용 방법

옵션 1: Python

• Python 3.x 필요
• 외부 라이브러리 불필요

python3 md2hml.py <입력파일.md> <출력파일.hml>

예시:

python3 md2hml.py README.md readme.hml

---

옵션 2: Node.js

• Node.js 필요
• 표준 라이브러리만 사용 (fs, path)

node md2hml.js <입력파일.md> <출력파일.hml>

예시:

node md2hml.js README.md readme.hml

---

옵션 3: TypeScript

• typescript 필요
• (선택) ts-node

컴파일 후 실행:

tsc md2hml.ts
node md2hml.js <입력파일.md> <출력파일.hml>

ts-node로 바로 실행:

npx ts-node md2hml.ts <입력파일.md> <출력파일.hml>

---

출력 파일 열기

1. 변환 명령을 실행합니다.
2. 생성된 .hml 파일을 한컴오피스 한글(HWP) 로 엽니다. (HWP 2018 이상 권장)
3. 표 크기 조정, 내용 수정 후 .hwp 형식으로 저장할 수 있습니다.

---

Markdown 지원 기능 표

기능	Markdown 문법	HWP 출력
제목	# Title	제목 1 스타일
굵게	**text**	굵은 글씨
기울임	*text*	기울임꼴
코드	`text`	고정폭 글꼴
목록	* Item	글머리 기호 목록
표	`	A	B	`	네이티브 HWP 표
인용문	> Text	들여쓰기 블록
이미지		이미지 내장
구분선	---	문단 하단 테두리

---