오픈소스 | Pandoc(팬독)

Pandoc(팬독)은 한마디로 "문서 파일 형식의 만능 통역사(변환기)"입니다.

소프트웨어 세상에는 MS 워드(.docx), 마크다운(.md), PDF, HTML, EPUB(전자책), HWP(한글) 등 수많은 문서 포맷이 존재하는데, Pandoc은 이 포맷들을 서로 자유자재로 변환해 주는 대표적인 오픈소스 도구입니다.

💡 왜 Pandoc이 그렇게 유명할까요?

1. 압도적인 호환 범위 (문서 변환의 끝판왕)

단순히 Text만 옮기는 게 아니라, 문서의 구조(제목 계층, 굵은 글씨, 표, 목록, 각주, 이미지, 수식 등)를 분석해서 상대방 포맷에 맞게 재구성해 줍니다.

• 워드(.docx) ➡️ 마크다운(.md)
• 마크다운(.md) ➡️ PDF 또는 HTML
• HTML ➡️ EPUB(전자책)
• LaTeX(수식 문서) ➡️ Word

2. 수많은 에디터의 '숨은 엔진'

Typora, Obsidian, VS Code, RStudio 등 우리가 사용하는 수많은 인기 문서/노트 에디터에서 "워드로 내보내기"나 "마크다운으로 가져오기" 버튼을 누를 때, 배후에서 실제로 변환 작업을 수행하는 엔진이 바로 Pandoc입니다.

⚙️ 어떻게 작동하나요?

Pandoc은 별도의 그래픽 화면(GUI)이 없는 명령줄(CLI / 터미널) 프로그램입니다. 터미널에서 한 줄의 명령어로 변환을 실행합니다.

Bash

 

# 기본 변환 (워드 파일 -> 마크다운 파일)
pandoc input.docx -o output.md

# 이미지까지 폴더로 따로 추출하며 마크다운으로 변환
pandoc input.docx -f docx -t gfm --extract-media=./images -o output.md

• -f: From (원래 파일 형식)
• -t: To (바꿀 파일 형식)
• -o: Output (결과 파일명)

🎯 주요 장단점

• 장점:
  • 무료 & 오픈소스: 누구나 무료로 사용할 수 있으며 꾸준히 업데이트됩니다.
  • 속도와 정확도: 수십 페이지짜리 문서도 몇 초 만에 변환하며, 표나 이미지 보존력이 매우 뛰어납니다.
  • 자동화 가능: 스크립트를 짜서 파일 수백 개를 한 번에 변환할 수 있습니다.
• 단점:
  • 검은 화면(터미널) 진입장벽: 명령어 입력 방식이 생소한 사용자에게는 처음에 조금 어렵게 느껴질 수 있습니다. (그래서 보통 Typora 같은 에디터를 통해 간접적으로 많이 활용합니다.)

한 줄 요약: 문서 변환계의 **'스위스 아미 나이프(맥가이버 칼)'**로, 마크다운과 워드·PDF·HTML 간 변환에서 가장 빠르고 정확한 표준 도구입니다.