Markdown을 Word로 변환: 온라인·Pandoc 방법과 DOCX 확인

작업에 맞는 Markdown → DOCX 변환 방법 고르기

해야 할 작업	시작할 방법	확인할 항목
프로그램 설치 없이 한 파일 변환	브라우저 변환 도구	저장된 제목, 표 셀, 링크
여러 문서를 같은 절차로 처리	Pandoc과 직접 관리하는 스크립트	입력 형식, 옵션, 대표 결과
정해진 Word 스타일 적용	Pandoc과 참조 DOCX	제목 스타일, 글꼴, 표 모양
복잡한 페이지 구성 완성	구조를 변환한 뒤 Word에서 조정	페이지 나눔, 이미지 배치, 병합 셀, 머리글

MDFormats는 문서를 브라우저에서 처리합니다. 다만 미리보기에 외부 이미지를 표시하면 해당 주소로 네트워크 요청이 발생할 수 있습니다. 로컬 처리와 모든 자료의 오프라인 사용은 다릅니다. Pandoc도 문서에서 참조한 외부 자료를 가져올 수 있으므로, 내부 문서라면 이미지와 링크도 확인하세요.

받는 사람이 사용하는 앱, 글꼴, 페이지 설정에 따라 줄바꿈과 페이지 나눔이 달라질 수 있습니다. 미리보기는 원문의 구조를 확인하는 수단이며, 최종 파일의 배치를 보장하지는 않습니다.

대조하기 쉬운 짧은 문서 준비하기

다음 원문을 UTF-8로 report.md에 저장하거나 변환 도구에 붙여 넣으세요. 식별 번호는 앞자리 0이나 표의 행이 바뀌었는지 확인하는 기준입니다. 링크는 설명용 주소이며 실제 프로젝트 문서가 아닙니다.

# 문서 인수인계

전달 전에 **최종 원고**를 확인합니다.

## 검토 기록

| 문서 | 식별 번호 | 상태 |
| --- | --- | --- |
| 설치 안내 | DOC-0017 | 확인 완료 |
| 테스트 목록 | QA-0023 | 보완 필요 |

## 전달 전 작업

- Markdown 원본 보관
- 내려받은 Word 파일 열기

`npm run build`는 해당 프로젝트에서만 실행합니다.

[예시 문서](https://example.com/docs)

머리글을 포함해 3행 3열인 표입니다. npm run build는 인라인 코드 표시를 확인하기 위한 예시이므로 이 안내를 따라 하려고 실행할 필요가 없습니다. 첫 시도에서는 파일 이름, 번호, Markdown 기호를 그대로 두면 변환 때문에 생긴 차이를 찾기 쉽습니다.

브라우저에서 변환한 뒤 실제 DOCX 확인하기

1. Markdown → Word에 예시를 붙여 넣거나 report.md를 불러옵니다.
2. 두 단계의 제목, 표, 서로 분리된 두 목록 항목을 확인합니다. 표 대신 세로 막대 문자가 보이면 먼저 원문을 고칩니다.
3. DOCX 다운로드 기능으로 파일을 저장합니다.
4. Word 또는 받는 사람이 사용하는 호환 앱에서 엽니다.
5. QA-0023 셀을 눌러 글자를 수정해 봅니다. 표 이미지가 아니라 편집 가능한 셀이어야 합니다.

번호와 상태를 행별로 대조하고 링크 주소도 확인하세요. 보기 좋은 표라도 값이 다른 행에 들어가면 사용할 수 없습니다. 넓은 표는 반복되는 머리글을 줄이거나 나누고, 필요하면 Word에서 열 너비를 조정합니다. Markdown 정렬 기호가 모든 DOCX 변환기에서 같은 결과를 뜻하지는 않습니다.

Pandoc은 무엇이며 언제 필요한가요?

Pandoc은 명령줄에서 사용하는 오픈 소스 문서 변환 프로그램입니다. 컴퓨터에 설치한 뒤 입력 파일과 출력 형식을 지정합니다. 명령을 반복하거나 스크립트에 넣을 때 유용하지만, MDFormats의 필수 구성 요소는 아닙니다.

공식 설치 안내를 따른 뒤 버전을 확인하고 같은 원문을 변환합니다.

pandoc --version
pandoc report.md -f gfm -t docx -o report.docx

-f gfm은 이 예시의 파이프 표를 지원하는 GitHub Flavored Markdown을 선택합니다. -t docx는 출력 형식이고 -o는 저장할 파일 이름입니다. report.md가 있는 폴더에서 실행하거나 파일 경로를 지정하세요. 파일을 찾을 수 없다는 오류는 명령을 반복하기 전에 경로부터 확인해야 합니다.

팀에서 공유할 절차에는 버전도 기록하세요. 도구를 업데이트하거나 원문 문법을 바꿨다면 대표 문서로 다시 확인합니다.

참조 DOCX로 Word 스타일 관리하기

Pandoc은 참조 문서의 스타일과 문서 속성을 사용할 수 있습니다. 예제로 DOCX 파일을 만들고 Word에서 필요한 스타일을 수정해 저장한 뒤 변환에 적용합니다.

pandoc report.md -f gfm -t docx -o reference.docx

reference.docx를 Word에서 열고 필요한 스타일을 수정한 뒤 저장하고 다음 명령을 실행하세요. 조정한 스타일을 재사용할 때는 참조 파일을 다시 생성해 덮어쓰지 마세요.

pandoc report.md -f gfm -t docx --reference-doc=reference.docx -o report-styled.docx

참조 문서의 본문은 무시됩니다. 결과물에 그 문서의 본문이나 표지를 붙이는 기능이 아닙니다. 지원하는 설정은 공식 참조 문서 설명을 확인하세요. 첫 결과물에서 제목, 글꼴, 표 너비, 페이지 나눔을 점검해야 합니다. 명령을 반복할 수 있어도 레이아웃 검토는 필요합니다.

이미지, 수식, 복잡한 배치는 따로 확인하기

현재 MDFormats의 DOCX 내보내기는 이미지를 포함하지 않습니다. 미리보기에 보여도 Word에서 별도로 삽입하고 위치를 확인해야 합니다. 원본 이미지 파일도 보관하세요.

수식은 Markdown 텍스트로 출력되며 Word의 기본 수식 개체로 변환되지 않습니다. 편집 가능한 수식이 필요하면 Word에서 만들거나 해당 표기법을 검증한 다른 방법을 선택하세요. Pandoc과 MDFormats의 지원 범위는 다르므로 같은 개체가 만들어진다고 가정하면 안 됩니다.

병합 셀, 떠 있는 이미지, 머리글과 바닥글, 정확한 페이지 나눔도 최종 앱에서 확인해야 합니다. Markdown은 문서 구조를 표현하지만 Word의 모든 페이지 배치를 지정하지는 않습니다.

전달 전에 저장된 문서 전체 확인하기

처음, 중간, 끝을 살펴보세요. 이 예시에서는 제목 단계, 3행 3열, 두 번호, 코드, 링크, 마지막 문단을 대조합니다. 셀을 조금 수정해 저장하면서 받는 사람에게 필요한 편집이 가능한지도 확인하세요.

수정한 DOCX를 돌려받았다면 Word → Markdown으로 후속 작업의 초안을 만들 수 있습니다. 다만 왕복 변환이 모든 서식을 보존하지는 않습니다. 받은 문서와 대조하고 두 원본을 남겨 두세요.

자주 묻는 질문

MD 파일을 Word에서 바로 열 수 있나요?

텍스트를 읽는 것과 Word 제목 및 표 구조를 만드는 것은 다릅니다. 편집 가능한 구조가 필요하면 DOCX로 변환한 뒤 확인하세요.

온라인 변환에도 Pandoc 설치가 필요한가요?

아니요. MDFormats는 브라우저에서 사용합니다. Pandoc은 명령줄이나 참조 스타일을 원하는 사람을 위한 다른 선택지입니다.

DOCX가 미리보기와 완전히 같나요?

보장하지 않습니다. 글꼴, 앱, 페이지 설정에 따라 줄바꿈이 달라집니다. 특히 넓은 표, 이미지, 수식을 내려받은 파일에서 확인하세요.

내보낸 뒤에도 Markdown을 보관해야 하나요?

보관하는 편이 좋습니다. Markdown은 원고 수정에, DOCX는 Word 편집에 사용하세요. Markdown → Word 변환은 저장한 문서의 내용을 확인하는 단계까지 포함합니다.