마크다운으로 쓴 문서를 Word에서 열어 수정해야 한다면 Pandoc으로 DOCX 파일을 만들 수 있습니다. Pandoc은 무료 오픈소스 명령줄 문서 변환기입니다. Windows x64용 3.12.1 설치 파일은 공식 GitHub 릴리스에서 제공하며, 설치 후 터미널에서 입력 파일과 저장할 DOCX 이름을 지정합니다.
먼저 report.md를 report.docx로 바꾸는 작업부터 해 보세요. 설치 뒤 입력 파일이 있는 폴더에서 명령을 실행하고, Word에서 결과를 열어야 변환이 제대로 됐는지 확인할 수 있습니다.
마크다운을 DOCX로 바꿀 때 Pandoc이 하는 일
Pandoc 공식 사이트는 Markdown과 Microsoft Word DOCX를 모두 읽고 쓸 수 있는 형식으로 안내합니다. 마크다운 원본의 제목, 문단, 목록 같은 구조를 Word 문서로 옮기는 데 알맞습니다. 다만 복잡한 레이아웃이나 Word 고유 서식을 픽셀 단위로 복제하는 도구는 아닙니다. 표나 이미지가 많은 문서는 변환 뒤 Word에서 배치와 경로를 확인하세요.
Windows용 Pandoc은 메뉴를 눌러 파일을 고르는 일반적인 데스크톱 편집기가 아닙니다. PowerShell이나 명령 프롬프트에서 pandoc 명령으로 입력 파일과 출력 파일을 지정합니다. 공식 사이트의 별도 브라우저 체험 화면은 변환 형식을 살펴볼 수 있지만, Windows에 설치하는 명령줄 프로그램의 창은 아닙니다.
공식 Pandoc 체험 화면에서 확인하는 입력 형식과 변환 결과
사진은 pandoc.org의 Try pandoc 웹 체험 화면입니다. 왼쪽 Markdown 입력과 오른쪽 HTML 결과, 위쪽의 from/to 형식 선택을 보여 줍니다. Windows MSI로 설치하는 Pandoc은 별도의 GUI 창 대신 터미널 명령으로 사용합니다. 이 사진을 Windows 3.12.1의 실행 화면으로 표시하지 않습니다.
| 프로그램 | Pandoc 명령줄 문서 변환기 |
| 제작 | John MacFarlane과 기여자 |
| 공식 파일 | pandoc-3.12.1-windows-x86_64.msi |
| 파일 크기 | 41,869,312바이트 |
| 지원 환경 | Windows x64 · macOS · Linux |
| 공식 안내 | pandoc.org 및 jgm/pandoc GitHub 릴리스 |
Windows x64 공식 설치 파일 고르기
공식 설치 안내의 Windows 항목은 GitHub 릴리스의 MSI 설치 파일을 가리킵니다. 2026년 10월 확인한 최신 릴리스는 3.12.1이며 파일명은 pandoc-3.12.1-windows-x86_64.msi입니다. x86_64는 64비트 Windows용이라는 뜻입니다. 공식 릴리스의 파일 크기는 41,869,312바이트로 표시됩니다. 파일명과 배포 주소를 확인한 뒤 자신의 PC가 64비트인지 Windows 시스템 정보에서 대조하세요.
Pandoc 공식 설치 안내에 따르면 MSI 설치는 이전 버전을 대체하고 명령어를 찾을 수 있도록 PATH를 갱신합니다. ZIP 배포판도 있지만 Windows x64에서 안내하는 공식 파일은 MSI입니다. ZIP으로 설치하면 실행 파일의 위치를 직접 관리해야 하므로 처음 쓰는 Windows 사용자에게는 MSI가 간단합니다. macOS와 Linux 사용자는 같은 설치 안내에서 해당 운영체제의 패키지를 따로 선택해야 합니다.
- Windows 설정의 시스템 정보에서 64비트 운영체제인지 확인합니다.
- 공식 3.12.1 릴리스의
pandoc-3.12.1-windows-x86_64.msi를 선택합니다. - 받기가 끝나면 파일명을 다시 대조하고 Windows 설치 안내에 따라 MSI 설치를 진행합니다.
PowerShell에서 입력 파일이 있는 폴더로 이동하기
설치가 끝났다면 PowerShell을 새로 열어 pandoc --version을 입력해 보세요. 버전 정보가 나오면 터미널에서 Pandoc을 찾은 것입니다. 기존에 열어 둔 터미널은 설치 때 갱신된 PATH를 반영하지 않을 수 있으므로 새 창으로 확인하는 편이 정확합니다. 명령을 인식하지 못하면 설치가 완료됐는지 확인하고 새 터미널에서 다시 실행하세요.
예를 들어 report.md가 문서 폴더에 있다면 PowerShell에서 cd로 그 폴더로 이동합니다. 파일명에 공백이 있으면 입력과 출력 이름을 각각 따옴표로 묶어야 합니다. 현재 폴더에 파일이 있는지 dir로 확인한 뒤 변환 명령을 넣으면 파일 경로를 잘못 적는 일을 줄일 수 있습니다.
- 새 PowerShell을 열고
pandoc --version으로 명령이 인식되는지 확인합니다. cd 'C:\Users\사용자이름\Documents'처럼 마크다운 파일이 있는 폴더로 이동합니다.dir report.md로 입력 파일 이름과 위치를 확인합니다.
Markdown 파일을 Word DOCX로 변환하고 확인하기
현재 폴더에 report.md가 있다면 pandoc report.md -o report.docx를 입력하세요. Pandoc 사용 설명서의 -o는 결과를 파일로 저장하는 옵션이며, 파일 확장자로 출력 형식을 추정할 수 있습니다. Markdown과 DOCX를 더 분명히 지정하려면 pandoc -f markdown -t docx report.md -o report.docx라고 적어도 됩니다. 두 명령을 한 번에 실행할 필요는 없습니다.
처음 연습한다면 report.md에 # 주간 보고라는 큰 제목을 한 줄 쓰고, 다음 줄에 ## 완료한 일이라는 작은 제목과 - 문서 정리 같은 목록을 넣어 저장하세요. 파일 탐색기가 확장자를 숨긴 상태라면 실제 이름이 report.md.txt가 아닌지도 확인합니다. 입력 파일 자체가 마크다운 문서여야 명령 끝의 .md와 맞습니다. 이 작은 예제로 먼저 변환하면 원본 내용과 Word 결과를 쉽게 비교할 수 있습니다.
명령이 끝난 뒤 dir report.docx로 파일이 생겼는지 확인하고 Word에서 직접 열어 보세요. 큰 제목과 작은 제목이 구분되는지, 목록 항목이 각각 나타나는지 확인합니다. Word의 탐색 창에서 제목이 계층대로 보이는지도 살펴보면 긴 문서의 구조를 빠르게 점검할 수 있습니다. 제목이 일반 문장처럼 보인다면 원본의 #와 ## 앞뒤 공백, 줄바꿈을 확인하고 변환을 다시 실행하세요. Word 문서에 계속 손볼 내용이 있다면 원본 Markdown을 수정한 뒤 DOCX를 다시 만들 것인지, 변환된 DOCX를 최종 편집본으로 삼을 것인지 먼저 정하세요. 두 파일을 동시에 따로 고치면 내용이 달라지기 쉽습니다.
Pandoc은 서로 다른 문서 형식의 구조를 변환하므로 모든 서식이 그대로 재현되지는 않습니다. 표와 이미지가 있는 문서는 변환 뒤 Word에서 배치와 크기를 살펴야 작업이 끝납니다. 그림이 빠졌다면 Markdown의 이미지 경로를 확인하고, 표가 밀렸다면 Word에서 너비를 조정한 뒤 최종 파일을 저장하세요. 원본과 변환 결과를 함께 보관하려면 파일 이름에 날짜나 버전을 붙여 구분하세요. 수정 전 결과를 보존하고 싶다면 다음 변환에서는 report-revised.docx처럼 다른 출력 이름을 지정할 수 있습니다.
- 입력 파일이 있는 폴더에서
pandoc report.md -o report.docx를 실행합니다. dir report.docx로 결과 파일이 생겼는지 확인합니다.- Word에서 DOCX를 열어 제목·목록·표·이미지를 살핀 뒤 필요한 서식을 정리합니다.
파일명에 공백이 있거나 결과가 예상과 다를 때
회의 기록.md처럼 이름에 공백이 있다면 pandoc '회의 기록.md' -o '회의 기록.docx'처럼 각각 따옴표로 묶으세요. 명령에서 입력 파일을 찾지 못한다면 현재 폴더에 있는 실제 파일명과 확장자를 dir로 먼저 확인합니다. 바탕화면이나 다른 폴더의 파일을 변환할 때는 전체 경로를 따옴표로 감싸거나 해당 폴더로 이동한 뒤 실행하세요.
이미지가 Word 결과에 빠졌다면 원본 Markdown의 이미지 경로가 실제 파일을 가리키는지 확인합니다. 예를 들어 원본에 가 적혀 있다면 문서가 놓인 위치와 images 폴더의 관계를 다시 살펴보세요. 원본과 그림 파일을 각각 다른 폴더로 옮겼다면 경로도 바뀌어야 합니다. 그림은 그대로 둔 채 명령을 여러 번 실행해도 잘못 적힌 경로가 저절로 고쳐지지는 않습니다.
복잡한 표가 달라 보이면 Word에서 변환 결과를 직접 확인하고 표 너비 등을 조정하세요. 표 안의 긴 주소나 긴 코드 때문에 한 열이 넓어졌다면 Word에서 열 너비와 줄바꿈을 손보는 편이 빠릅니다. 반대로 내용 자체가 빠졌다면 출력 파일만 보지 말고 Markdown 원본의 표 구분선과 셀 수부터 다시 확인하세요. 변환 명령에 PDF 확장자를 적으면 별도 PDF 엔진이 필요할 수 있지만, 이 글의 DOCX 작업에는 PDF 엔진을 준비할 필요가 없습니다.
- 입력 파일 오류가 나면
dir로 현재 폴더와 실제 파일명을 확인합니다. - 공백 있는 경로는 작은따옴표로 감싸 다시 실행합니다.
- DOCX가 만들어졌더라도 Word에서 그림과 표를 열어 결과를 점검합니다.
Windows와 다른 운영체제에서 선택할 배포판
이 글의 공식 파일 버튼은 Windows x64 MSI 한 개입니다. Windows가 아니라면 그 파일을 설치하지 말고 Pandoc 설치 안내의 macOS 또는 Linux 절에서 해당 운영체제의 배포 방식을 고르세요. 공식 설치 문서는 macOS 설치 패키지와 Homebrew 등 대안, Linux 배포판별 방법을 구분해 설명합니다.
여러 설치 방식을 섞으면 Pandoc 사본이 둘 이상 생길 수 있습니다. 공식 설치 안내 역시 설치 방식을 바꿀 때 기존 Pandoc을 먼저 제거하는 편을 권합니다. pandoc --version이 기대한 버전과 다르다면 여러 위치에 설치되어 있는지 확인하고 사용할 설치 방식 하나를 정리하세요.
- Windows x64이면 3.12.1 MSI 파일명을 확인합니다.
- macOS·Linux이면 공식 설치 안내에서 자신의 운영체제 항목을 선택합니다.
- 변환 전에 터미널의
pandoc --version으로 사용 중인 버전을 확인합니다.
자주 묻는 질문
Pandoc은 무료인가요?
네. 공식 GitHub 저장소에서 GPL-2.0 라이선스와 무료로 받을 수 있는 3.12.1 배포 파일을 확인할 수 있습니다.
마크다운을 Word 파일로 바꾸는 명령은 무엇인가요?
입력 파일이 있는 폴더에서 pandoc report.md -o report.docx를 실행합니다. 다른 파일명이라면 두 이름을 실제 파일명으로 바꾸세요.
설치했는데 pandoc 명령을 찾지 못합니다.
MSI 설치가 끝났는지 확인하고 PowerShell을 새로 열어 pandoc --version을 다시 실행하세요. 공식 설치 안내는 MSI가 PATH를 갱신한다고 설명합니다.
워드로 바꾼 뒤 그림이나 표도 확인해야 하나요?
네. Pandoc은 문서 형식의 구조를 변환하므로 Word에서 DOCX를 열어 그림 경로, 표 너비와 배치를 확인하세요.
PDF 변환용 프로그램도 설치해야 하나요?
이 글의 Markdown → DOCX 변환에는 필요하지 않습니다. PDF 출력은 별도의 엔진이 필요할 수 있습니다.
DOCX가 열리는지 확인하면 변환 작업이 끝납니다
Windows x64 PC라면 Pandoc 공식 3.12.1 MSI를 설치하고 새 PowerShell에서 pandoc --version을 확인하세요. 마크다운 파일이 있는 폴더에서 pandoc report.md -o report.docx를 실행하면 같은 폴더에 Word용 파일을 만들 수 있습니다.
파일이 만들어진 것만으로 끝내지 말고 Word에서 열어 제목·목록·이미지·표를 확인하세요. 파일 경로를 찾지 못하면 현재 폴더와 확장자를 먼저 점검하면 됩니다.
공식 자료와 확인일
Pandoc 공식 제품 소개와 지원 형식 · Pandoc 공식 설치 안내 · Pandoc 3.12.1 공식 릴리스와 Windows MSI · Pandoc 공식 사용 설명서 · Pandoc 공식 라이선스 · 공식 Try pandoc 웹 체험 | 2026-10-20
