문서 변환의 만능 칼 Pandoc이 스무 살이 됐어요 — 철학 교수가 만든 20년짜리 오픈소스

이 도구, 한 번쯤은 신세 졌을 거예요

문서 변환 도구 Pandoc이 올해로 스무 살을 맞았어요. 제작자가 직접 20년을 돌아보는 글을 올렸는데요. Pandoc이 뭐냐면, 마크다운, HTML, LaTeX, 워드(docx), EPUB, PDF 등 수십 가지 문서 형식을 서로 변환해주는 커맨드라인 도구예요. pandoc report.md -o report.docx 한 줄이면 마크다운 문서가 워드 파일이 되는 식이죠. 개발 문서를 PDF로 뽑거나, 위키 문서를 옮기거나, 전자책을 만들 때 뒤에서 조용히 일하고 있는 경우가 많아서, 직접 설치한 적이 없어도 간접적으로는 다들 한 번쯤 신세를 졌을 도구예요.

만든 사람의 이력이 특이한데요. John MacFarlane은 전업 개발자가 아니라 UC 버클리의 철학 교수예요. 2006년, 자기 논문과 강의 자료를 다루다가 필요해서 만들기 시작한 개인 프로젝트가 20년을 이어져 온 거죠.

핵심 설계: 가운데에 '공통 언어'를 둔다

Pandoc의 설계에서 배울 점이 많은데요. N개의 형식을 서로 직접 변환하려면 조합이 폭발해요. 형식이 30개면 변환기가 30×29개, 즉 870개나 필요하거든요. Pandoc은 이 문제를 우아하게 풀었어요. 모든 문서를 일단 내부의 공통 구조로 읽어들이는 거예요. 이게 뭐냐면, 문서를 '제목', '문단', '목록', '표' 같은 요소들의 트리로 표현한 중간 형태(AST)인데요. 어떤 형식이든 일단 이 공통 언어로 번역해두면, 거기서 다시 원하는 형식으로 써내기만 하면 돼요. 그러면 읽는 쪽(리더) 30개와 쓰는 쪽(라이터) 30개, 합쳐서 60개만 있으면 모든 조합이 커버되는 거죠. 컴파일러가 소스 코드를 중간 표현으로 바꾼 뒤 여러 타깃으로 내보내는 것과 똑같은 원리예요. '좋은 중간 추상화 하나가 조합 폭발을 잠재운다'는 교과서적인 사례죠.

이 구조 덕분에 확장도 유연해요. Lua 필터라는 기능으로 변환 중간에 이 트리를 직접 조작할 수 있거든요. 예를 들어 '모든 이미지에 자동으로 번호 붙이기' 같은 커스텀 규칙을 짧은 스크립트로 끼워 넣을 수 있어요. 학술 인용 관리(CSL)도 지원해서 참고문헌 형식을 자동으로 맞춰주기 때문에 논문 쓰는 사람들에게는 필수 도구가 됐고요. 참고로 전체가 Haskell로 작성돼 있어서, 함수형 언어가 실전에서 살아남은 대표 사례로도 자주 언급돼요.

20년의 맥락, 그리고 지금 다시 주목받는 이유

MacFarlane의 영향력은 Pandoc 밖으로도 이어졌어요. 마크다운은 원래 구현체마다 동작이 미묘하게 달라서 혼란스러웠는데, 이를 표준화한 CommonMark 명세 작업에 핵심 인물로 참여했거든요. 우리가 지금 어디서나 비슷하게 동작하는 마크다운을 쓰는 데에 이 사람의 지분이 상당한 거죠. 그리고 요즘 Pandoc이 다시 주목받는 이유가 하나 더 있어요. LLM 시대에 온갖 형식의 문서를 마크다운으로 바꿔서 AI에게 먹이는 수요가 폭증했거든요. RAG(문서를 검색해 AI에게 근거 자료로 주는 기법) 파이프라인의 첫 단계가 대부분 '문서를 마크다운으로 변환하기'인데, 마이크로소프트의 markitdown 같은 신생 도구들이 이 시장에 등장했지만, 20년간 온갖 이상한 문서에 단련된 Pandoc의 견고함은 쉽게 따라잡기 어려워요. curl이나 SQLite처럼, 한 사람이 오래 가꾼 오픈소스가 인프라급 존재가 된 계보에 속하는 프로젝트예요.

한국 개발자에게 주는 시사점

실무 활용처가 정말 많아요. 사내 보고서를 마크다운으로 쓰고 워드나 PDF로 출력하는 자동화, 기술 블로그 글을 발표 자료로 변환하기, CI 파이프라인에서 문서를 자동 빌드하기, 논문이나 기술 문서 작업까지요. 한 번 익혀두면 10년은 쓰는 도구라 투자 가치가 충분하고요. 설계 관점에서도 배울 게 있어요. 여러 시스템을 연동해야 할 때 일대일로 연결하지 말고 공통 중간 형식을 하나 두는 것, 이 패턴은 문서 변환뿐 아니라 데이터 파이프라인 설계 어디에나 적용되는 지혜거든요.

한줄 정리: 철학 교수의 개인 프로젝트가 20년 동안 문서 세계의 공용 인프라로 자랐고, LLM 시대에 오히려 더 중요해지고 있어요. 여러분의 문서 작업 흐름에서 Pandoc을 쓰고 계신가요? 아니면 요즘 나온 다른 변환 도구를 쓰시나요?