이 변환기가 하는 일
Word 문서는 결국 Markdown이 되는 콘텐츠의 흔한 출발점입니다. 문서 초안, 블로그 글, 회의록, 강의 자료 같은 것들입니다. Word에서 Markdown 파일로 복사하면 구조가 사라지고, 다시 입력하자니 시간이 오래 걸립니다.
이 워드 마크다운 변환기는 .docx 파일을 두 단계로 읽습니다. 먼저 mammoth 라이브러리가 문서를 겉모양이 아니라 스타일을 기준으로 단순한 HTML로 바꿉니다. 제목 1 스타일의 문단은 최상위 제목이, 글머리 기호 문단은 목록 항목이 되는 식입니다. 그다음 Turndown이 그 HTML을 표 처리 규칙을 더해 Markdown으로 바꿉니다. 두 단계 모두 브라우저에서 실행됩니다.
사용 방법
- Word 파일 선택을 누르거나
.docx파일을 상자에 끌어다 놓습니다. - 파일을 읽자마자 아래에 Markdown이 나타납니다.
- 필요하면 옵션을 바꿉니다. 파일을 다시 열지 않아도 결과가 바뀝니다.
- 이미지: 제외(대체 텍스트 유지) 또는 데이터 URL로 포함
- 제목 스타일: # 기호(
#) 또는 밑줄식 제목 - 글머리 기호: 목록 항목에 쓸
-,*,+
- 미리보기로 렌더링된 Markdown을 확인합니다. 입력란에서 텍스트를 직접 고칠 수도 있습니다.
- 복사를 누르거나, 다운로드로 문서 이름을 딴
.md파일을 저장합니다.
상태 줄에는 단어 수와 변환 중에 생긴 메모가 표시됩니다. 인식하지 못한 Word 스타일이 있으면 여기서 알려 줍니다.
예시
제목 1, 굵은 글씨와 기울임 글씨가 섞인 문단, 제목 2, 항목 두 개짜리 글머리 기호 목록, 3행짜리 표를 넣은 작은 시험용 문서를 만들었습니다. 변환기가 돌려준 결과입니다.
# Meeting Notes
The team agreed to ship the **new pricing page** on *Friday*.
## Action items
- Update the screenshots
- Email the beta users
| Owner | Task | Due |
| --- | --- | --- |
| Priya | Copy review | Wed |
| Sam | QA pass | Thu |Word 표는 HTML처럼 헤더 행을 따로 표시하지 않고, 셀마다 자체 문단을 가집니다. Turndown을 기본 설정으로 쓰면 이런 표는 HTML 그대로 남습니다. 이 변환기는 첫 행을 헤더로 쓰고 각 셀을 한 줄로 합쳐서 진짜 Markdown 표를 만듭니다.
변환되는 것과 되지 않는 것
유지되는 것:
- Word 기본 제목 스타일로 지정한 제목
- 문단, 굵게, 기울임, 취소선
- 글머리 기호 목록과 번호 목록(중첩 목록 포함)
- 링크
- 표(첫 행을 헤더로 사용)
- 각주와 미주(끝에 목록으로 정리)
- 이미지 대체 텍스트, 또는 포함을 고르면 이미지 전체
유지되지 않는 것:
- 글꼴, 색상, 크기, 페이지 레이아웃
- 도형, SmartArt, 차트
- 메모와 변경 내용 추적
- 머리글과 바닥글
- 병합된 표 셀. 표가 깨지지 않도록 빈 셀로 채웁니다.
Markdown은 페이지 디자인을 표현할 수 없으므로 이는 예상된 결과입니다. 목표는 구조가 그대로 살아 있는 깔끔하고 이식성 좋은 텍스트입니다.
더 좋은 결과를 얻는 팁
- 실제 제목 스타일을 쓰세요. 제목처럼 보이게 서식만 바꾼 텍스트는 일반 문단으로 저장됩니다. 변환하기 전에 Word에서 해당 텍스트를 선택하고 홈 탭의 스타일에서 제목 1, 제목 2, 제목 3을 적용하세요. 한국어판 Word의 ‘제목 1’ 같은 기본 스타일이 바로 이 제목 스타일입니다.
- 실제 목록을 쓰세요. 대시나 숫자를 직접 입력해 시작한 줄은 목록 항목이 아니라 문단입니다. Word의 목록 버튼으로 만든 목록이어야 제대로 인식됩니다.
- 긴 표를 확인하세요. 여러 문단이 든 셀은 한 줄이 됩니다. 표에 긴 글이 들어 있다면 Markdown에서는 목록이 더 읽기 좋을 수 있습니다.
- 결과를 정리하세요. 마크다운 포매터는 표의 열을 맞추고 문단 줄바꿈을 한 가지 스타일로 정리합니다.
- PDF만 있나요? PDF 마크다운 변환기를 쓰세요. 다만 PDF는 구조를 저장하지 않으므로, 둘 다 있다면
.docx가 더 좋은 결과를 냅니다. - HTML이 있나요? HTML 마크다운 변환기가 목록, 링크, 표에 같은 규칙을 적용합니다.
- 한컴오피스 한글(HWP) 문서인가요? 이 도구는
.docx파일만 받습니다. 한글에서 다른 이름으로 저장할 때 파일 형식을 Word 문서(.docx)로 바꿔 저장한 뒤 변환하세요.
워드를 마크다운으로 바꾸는 다른 방법
- Pandoc은
.docx파일을 직접 읽습니다. 기본 형태는pandoc report.docx -o report.md이며, 이미지를 폴더에 저장할 수도 있습니다. - Word와 Google 문서에는 Markdown 내보내기 기능이 기본으로 들어 있지 않습니다. Google 문서는 환경설정에서 해당 기능을 켜면 콘텐츠를 Markdown으로 복사할 수 있습니다.
- Python: 이 도구의 첫 단계를 맡는 mammoth 패키지는 Python용도 있어서, 스크립트에서 HTML이나 Markdown을 만들 수 있습니다.
개인정보 보호
파일은 브라우저의 파일 API로 읽고 메모리 안에서 변환합니다. 아무것도 업로드하지 않으므로 사내 문서와 초안도 기기 밖으로 나가지 않습니다. 탭을 닫으면 문서도 사라집니다.