먼저 알아둘 기준
Markdown은 문서의 의미 구조를 간단한 기호로 표현하며 종이 페이지의 정확한 배치를 목표로 하지 않습니다. HWP 제목 스타일은 # 헤딩으로, 번호·글머리표는 목록으로 바꾸는 방식이 적합합니다.
단순 표는 파이프 표 또는 HTML 표가 될 수 있지만 병합 셀과 중첩 구조는 직접 대응하지 않습니다. 복잡한 표를 무리하게 평탄화하면 셀 관계가 잘못 전달될 수 있어 미지원 또는 단순화 경고가 필요합니다.
내장 이미지는 assets 폴더로 추출해 상대 링크로 연결할 수 있습니다. 도형, 차트와 수식은 이미지로 보존할 수 있는 경우도 있지만 편집 가능한 원본 의미는 남지 않습니다.
실제 작업에서 보는 사례
01
‘제목 1’ 문단을 ‘# 프로젝트 개요’ 헤딩으로 변환합니다.
02
세 열 단순 표는 Markdown 파이프 표가 되지만 병합 셀은 일반 셀이나 HTML로 단순화합니다.
03
본문 사진은 assets/image-1.png로 저장하고 Markdown에 상대 경로를 넣습니다.
단계별로 확인하는 방법
- 1
본문 추출이 가능한 문서인지 형식과 보호 상태를 검사합니다.
- 2
이미지 포함 여부와 표 변환 방식을 선택합니다.
- 3
소스와 렌더링 미리보기를 나란히 보며 제목·목록·표를 확인합니다.
- 4
누락·단순화 목록을 검토하고 MD 또는 assets 포함 ZIP으로 저장합니다.
HWP 요소의 Markdown 변환 범위
| HWP 요소 | Markdown 결과 | 예상 변화 |
|---|---|---|
| 제목·문단 | 헤딩·일반 문단 | 페이지 위치 제외 |
| 강조·목록 | 굵게·기울임·목록 | 세부 스타일 단순화 |
| 단순 표 | 파이프 또는 HTML 표 | 폭·병합 제한 |
| 이미지 | assets 상대 링크 | 배치·크기 변화 |
| 도형·수식·차트 | 이미지·대체 문구 또는 제외 | 편집 정보 손실 |
주의할 점
- 변환 결과를 원본과 동일한 문서라고 표현하거나 제출용 원본 대신 사용하면 안 됩니다.
- 지원하지 않은 요소 수가 0이더라도 글꼴과 페이지 배치는 Markdown 특성상 달라집니다.
기술적 제한
- Markdown 표준 문법은 페이지 레이아웃, 병합 셀, 부동 개체와 정밀 타이포그래피를 표현하지 못합니다.
- HWP 스타일 식별과 Markdown 요소 매핑은 파서가 읽을 수 있는 스타일 메타데이터 범위에 의존합니다.