Markdown, Pandoc, 그리고 AI 판독 가능 에디션을 활용한 지속적인 도서 출판

Markdown, Pandoc, 그리고 AI 판독 가능 에디션을 활용한 지속적인 도서 출판

책의 규모가 커질수록 책을 쓰는 일은 더 어려워집니다.

단순히 글을 쓰는 행위 때문만이 아니라, 점점 길어지는 '쓰기-읽기 사이클 (write–read cycle)' 때문이기도 합니다.

새로운 장(chapter)이 추가될 때마다 다음 요소들이 증가합니다:

• 컨텍스트 크기 (context size)
• 일관성 관리 (consistency management)
• 구조 재편 비용 (restructuring costs)
• 업데이트 오버헤드 (update overhead)

어느 시점에 이르면, 방대한 분량의 책은 대규모 소프트웨어 시스템과 유사하게 작동하기 시작합니다.

그리고 소프트웨어 공학 (software engineering)은 이미 수년 전에 이러한 문제들의 상당 부분을 해결했습니다:

• 모듈성 (modularity)
• 관심사 분리 (separation of concerns)
• 자동화 (automation)
• 빌드 파이프라인 (build pipelines)
• 지속적 인도 (continuous delivery)

그래서 비즈니스 자동화에 관한 플레이북 (playbook)을 작성하던 중, 저는 도서 출판 자체에도 동일한 원칙을 적용하기 시작했습니다.

아이디어

하나의 거대한 문서를 유지하는 대신, 책을 모듈형 Markdown 파일로 분할했습니다:

001-introduction.md
002-automation.md
003-ai-systems.md

각 장은 독립적인 단위가 됩니다.

그다음 이를 중심으로 작은 출판 파이프라인 (publishing pipeline)을 구축했습니다.

이제 워크플로우는 다음과 같습니다:

장(chapter) 편집
→ 빌드(build) 클릭
→ 자동 생성:
...

소프트웨어 배포 파이프라인 (software deployment pipelines)과 매우 유사합니다.

AI 판독 가능 도서가 중요한 이유

책의 독자는 점점 두 부류로 나뉘고 있습니다:

인간 (humans)
+
기계 (machines)

점점 더 많은 양의 독서가 다음과 같은 매체를 통해 이루어질 것입니다:

• ChatGPT
• Claude
• Gemini
• AI 에이전트 (AI agents)
• RAG 시스템 (RAG systems)
• 내부 지식 시스템 (internal knowledge systems)

사람들은 수백 페이지를 수동으로 읽는 대신, 점점 더 책을 AI 시스템에 업로드하고 대화형으로 질의할 것입니다.

따라서 책은 다음과 같은 요건을 갖춰야 합니다:

• 기계 판독 가능 (machine-readable)
• 검색 가능 (searchable)
• 모듈형 (modular)
• AI 호환 가능 (AI-compatible)

이것이 바로 이 파이프라인이 동일한 소스 파일로부터 다음 두 가지를 모두 생성하는 이유입니다:

• 인간을 위한 스타일이 적용된 PDF
• LLM을 위한 통합 Markdown 에디션

프로젝트 구조

book/
  chapters/
  dist/
...

장(chapter) 예시:

book/chapters/001-introduction.md
book/chapters/002-automation.md

도구 (Tooling)

스택은 의도적으로 단순하게 구성되었습니다:

• VSCode
• Markdown
• Pandoc
• CSS
• PowerShell
• wkhtmltopdf

CMS 없음.
출판 플랫폼 없음.
벤더 종속 (Vendor lock-in) 없음.

빌드 스크립트 (Build Script)

빌드 스크립트는 다음을 수행합니다:

• 챕터 결합
• Markdown → HTML 변환
• 스타일 주입
• PDF 생성
• 결합된 Markdown 에디션 내보내기

예시:

$chapterFiles = Get-ChildItem `
  "book/chapters/*" `
  | Sort-Object Name

그 다음:

pandoc `
  combined.html `
  --pdf-engine=wkhtmltopdf `
...

핵심 원칙 (Core Principle)

전체 워크플로우는 다음을 중심으로 구축되었습니다:

content
≠
presentation

즉:

• Markdown = 아이디어 (ideas)
• CSS = 스타일링 (styling)
• 스크립트 = 자동화 (automation)

이를 통해 시스템의 확장성 (Scalability)을 유지합니다.

이것이 중요한 이유

저는 책이 점점 더 소프트웨어 시스템처럼 동작할 것이라고 생각합니다:

• 지속적으로 업데이트됨
• 모듈식 (Modular)
• 기계 판독 가능 (Machine-readable)
• 자동으로 출판됨

특히 다음 분야에서 그러합니다:

• 기술 서적
• 플레이북 (Playbooks)
• 운영 문서 (Operational documentation)
• AI 네이티브 지식 시스템 (AI-native knowledge systems)

저장소 (Repository)

전체 자동화 설정과 플레이북은 여기서 확인할 수 있습니다:

:contentReference[oaicite:0]{index=0}

만약 당신이 책, 대규모 문서 시스템, 또는 AI 호환 지식 베이스를 작성하고 있다면, 이 접근 방식이 도움이 될 수 있습니다.