브라우저를 벗어나지 않고 HWPX·DOCX·Markdown 변환하기
HWPX·DOCX·Markdown 사이를 오갈 때 문서의 의미 구조는 옮길 수 있지만 편집기마다 다른 지면 배치까지 똑같이 복제할 수는 없습니다. 이 가이드는 다섯 변환 방향, Markdown ZIP 구성, 표와 이미지 처리, 안전 한도, 그리고 결과를 확인하는 방법을 한곳에 정리합니다.
지원하는 다섯 방향
현재 제공하는 경로는 HWPX → DOCX, HWPX → Markdown, DOCX → Markdown, Markdown → DOCX, Markdown → HWPX입니다. 제목·문단·목록·표·이미지를 공통 의미 모델로 옮기고, 각 대상 형식이 표현할 수 있는 구조로 다시 씁니다.
| 입력 | 지원 출력 | 상태 |
|---|---|---|
| HWPX | DOCX, Markdown ZIP | 베타 |
| DOCX | Markdown ZIP | 안정 |
| Markdown ZIP | DOCX | 안정 |
| Markdown ZIP | HWPX | 베타 |
Markdown ZIP의 모양
Markdown 입력은 파일 하나가 아니라 Markdown ZIP입니다. 압축 파일 안에는 정확히 하나의 .md 또는 .markdown 문서가 있어야 하며, 그림은 그 문서를 기준으로 한 상대 경로에서 찾습니다. 문서에서 Markdown으로 내보낼 때도 같은 구조를 만들어 텍스트와 자산을 함께 전달합니다.
- report.md — 변환할 본문 하나
- assets/chart.png — 본문에서 !분기 차트로 가리키는 그림
- assets/logo.svg — 같은 assets/ 아래에 둘 수 있는 다른 그림
GFM 표와 안전한 HTML 표
단순한 격자 표는 GFM 파이프 표로 내보냅니다. 셀 병합처럼 GFM이 표현할 수 없는 구조는 제한된 안전한 HTML table로 내보내고 경고를 붙입니다. Markdown을 가져올 때도 허용된 표 요소와 속성만 해석하며 스크립트나 임의 HTML은 실행하지 않습니다.
| 원본 표 | Markdown 결과 | 확인할 점 |
|---|---|---|
| 행·열 병합 없음 | GFM 파이프 표 | 셀의 읽기 순서 |
| 행·열 병합 있음 | 안전한 HTML table | 병합 범위와 대상 편집기 지원 |
| 지원하지 않는 중첩 개체 | 보이는 텍스트 또는 생략 | 표시된 경고 |
이미지 이름과 가져오지 않는 이미지
문서에서 꺼낸 그림은 주변 텍스트와 원래 이름을 바탕으로 충돌하지 않는 이름을 받아 assets/에 저장됩니다. Markdown ZIP을 가져올 때는 압축 안에 실제로 있고 바이트 형식이 확인된 상대 경로 이미지만 사용합니다.
- 같은 이름은 번호를 붙여 덮어쓰지 않고 각각 보존합니다.
- 누락되었거나 지원하지 않는 이미지는 대체 텍스트를 남기고 경고합니다.
- https: 주소 같은 원격 이미지와 data: URL은 브라우저가 내려받지 않으며 보이는 텍스트만 남깁니다.
파일과 압축 묶음의 안전 한도
모든 처리는 브라우저 안에서 이루어지지만, 압축된 문서는 풀었을 때 훨씬 커질 수 있습니다. 아래 한도는 탭이 멈추거나 의도치 않은 압축 폭탄을 펼치는 일을 막기 위한 경계입니다.
| 항목 | 한도 | 동작 |
|---|---|---|
| 한 번에 선택하는 파일 | 5개 | 초과분은 받지 않음 |
| 큰 파일 안내 시작 | 50 MiB 초과 | 계속할지 확인 |
| 파일 하나의 입력 크기 | 200 MiB | 초과 시 거부 |
| 압축 해제 뒤 전체 크기 | 1 GiB | 초과 시 거부 |
| 압축 항목 수 | 10,000 | 초과 시 거부 |
| 압축 비율 | 200:1 | 10 MiB보다 큰 항목부터 초과 시 거부 |
경고를 읽고 대상 편집기에서 확인하기
결과의 경고는 어떤 구조가 단순화되었고 대신 무엇을 남겼는지 설명합니다. 내부 파서 문구를 그대로 보여 주지 않고, 파일 이름과 형식처럼 사용자가 확인할 수 있는 정보만 표시합니다. 변환 자체가 성공해도 경고가 있다면 해당 위치를 우선 확인하세요.
- 파일은 서버로 전송되지 않고 현재 브라우저의 전용 작업 스레드에서 처리됩니다.
- HWPX가 입력이거나 출력인 세 경로는 베타이므로 원본을 보관하세요.
- 내려받은 결과는 대상 편집기에서 열어 글꼴, 쪽 나눔, 병합 표, 이미지 순서를 확인하세요.
PrismMesh로 돌아가기