마크다운 파일을 워드로 변환하기 (.md → .docx)

💡마크다운(markdown, .md) 파일을 MS워드(word, .docx)로 변환하는 방법에 대해 작성한다.
vscode의 markdown-preview-enhanced와 유사한 출력물을 얻는 것을 목표로 한다.

 

Pandoc 다운로드 및 설치

"universal document converter" 라는 슬로건을 가진, 다양한 문서 형식을 서로 변환할 수 있는 툴  

윈도우, 리눅스, 맥 OS 환경을 모두 지원한다.  

 

1. 운영 중인 OS에 맞춰 도구를 설치한다. 

https://pandoc.org/installing.html

 

2. 설치 확인

pandoc -v

## -- 실행 결과
E:\0_01_Code\Docs\openstack-helm>pandoc -v
pandoc 3.8
Features: +server +lua
Scripting engine: Lua 5.4
User data directory: C:\Users\C\AppData\Roaming\pandoc
Copyright (C) 2006-2025 John MacFarlane. Web:  https://pandoc.org
This is free software; see the source for copying conditions. There is no
warranty, not even for merchantability or fitness for a particular purpose.

 

파일 변환

.md 파일이 위치한 디렉토리에서 아래 명령어를 실행한다. 

pandoc -f gfm input.md -o output.docx --syntax-highlighting=zenburn

 

• -f : 입력 포맷 지정, (--from)
• gfm : Github Flavored Markdown
  • Github 스타일의 마크다운 문법을 그대로 해석
  • 체크박스, 테이블, 취소선 같은 확장 문법을 지원
• -o : 출력 파일 지정, (--output)
• --syntax-highlighting : 코드 블록에 문법 하이라이팅 테마를 적용
  • 밝은계열
    • pygments (default), tango (오렌지/파랑), kate (연한색)
  • 어두은 계열
    • breezedark, espresso, zenburn