DOCX를 마크다운으로 바꾸면 좋은 경우
- 코드처럼 문서 관리 — 문서를 Git에 두고 변경 사항을 줄 단위로 검토할 수 있습니다.
- 메모 앱 — 워드 내용을 옵시디언, 로그시크, 노션으로 옮길 수 있습니다.
- 정적 사이트 — 마크다운은 Hugo, Jekyll, Astro, Docusaurus의 기본 형식입니다.
변환 방식
워드 문서를 먼저 mammoth.js로 의미 중심의 HTML로 바꾼 뒤, 요소마다 GitHub 방식 마크다운으로 옮깁니다. 본문 속 문자가 마크다운 문법으로 잘못 해석되지 않도록 이스케이프 처리합니다.
DOCX 파일이란?
DOCX는 2007년부터 Microsoft Word의 기본 문서 형식이며, Office Open XML(ISO/IEC 29500)이라는 국제 표준입니다. DOCX 파일은 ZIP 압축 파일로, 안에는 본문·스타일·번호 매기기·메모를 담은 XML 파일과 이미지를 담은 media 폴더가 들어 있습니다.
개방형 표준이라 Google 문서, LibreOffice, Apple Pages, WPS Office, 한컴오피스에서도 열립니다. 확장자가 .doc인 옛날 Word 파일은 다른 바이너리 형식이라 DOCX와 같지 않습니다.
마크다운(Markdown) 파일이란?
마크다운(.md)은 # 제목, **굵게**, *기울임*, - 목록처럼 일반 문자만으로 서식을 표현하는 가벼운 문서 작성 방식입니다. 원본 그대로 읽어도 자연스럽고, HTML로 깔끔하게 변환됩니다.
GitHub의 README 파일과 각종 기술 문서, 옵시디언(Obsidian) 같은 메모 앱, 노션(Notion) 내보내기, 정적 사이트 생성기 등 다양한 곳에서 쓰입니다.