본문으로 건너뛰기

나의 첫 LLM 실험: Claude Code를 활용한 복잡한 PDF의 마크다운 변환기

Claude Code CLI를 사용하여 복잡한 레이아웃의 PDF 강의 노트를 구조화된 마크다운 및 EPUB 형식으로 변환하는 실험적 과정과 프롬프트 전략을 공유합니다.

섹션별 상세

저자는 AI 기업들의 독점적 행태에 비판적이었으나, 웹사이트 업그레이드와 문서 변환 작업의 시간 절약을 위해 Claude Pro와 Claude Code CLI를 도입했습니다. CLI 도구는 기존의 채팅 인터페이스보다 개발자 친화적인 워크플로를 제공하며 파일 시스템에 직접 접근하여 작업을 수행합니다. 이를 통해 수동으로 처리하기 어려운 대량의 텍스트 변환 작업을 자동화하는 기반을 마련했습니다.
변환의 첫 단계로 PDF 내부의 스타일 구조를 먼저 파싱하여 제목, 본문, 이미지 등의 스타일 명칭을 확인하는 전략을 사용했습니다. 추출된 스타일 리스트를 별도 파일로 저장하고 이를 이후 프롬프트의 참조 데이터로 활용하여 변환의 정확도를 높였습니다. 이는 LLM이 문서의 구조를 오해하여 발생하는 할루시네이션을 방지하는 핵심적인 사전 작업입니다.
text
parse AlanMoore_Storytelling_BBCMaestro_CourseNotes-1.pdf and list styles
save to conversion-styles-document.md

PDF 문서의 내부 스타일 구조를 파싱하여 별도의 마크다운 파일로 저장하는 초기 분석 명령

문서 전체를 한 번에 변환하지 않고 YAML 헤더 생성, 목차 구성, 섹션별 본문 변환으로 단계를 나누어 처리했습니다. 각 섹션마다 2단 구성을 1단으로 변경하고 특정 스타일의 텍스트를 마크다운 헤더(H2, H3)로 매핑하는 구체적인 지시사항을 프롬프트에 포함했습니다. 결과적으로 복잡한 레이아웃의 PDF가 기기에서 읽기 좋은 표준 마크다운 파일들로 분할되어 생성되었습니다.
text
as a yaml key/value pairs, map subtitle "STORYTELLING" to the key "title". 
map title "ALAN MOORE" to the key "author". 
map quote "this is what a human face looks like after 40 years" to key "quote". 
map and append "course notes 3.2" to the key title. 
Save as storytelling-header.md

PDF의 텍스트 요소를 추출하여 마크다운용 YAML 헤더 형식으로 변환하는 프롬프트

text
extract full-bleed photos as same names as placeholder file names into subfolder "images".
convert all sections into single column format.
convert full-bleed photos to markdown images.
convert part headings to H2.
convert lesson headings to H3.
convert paragraphs to markdown format and ignore footers.
save to file named "storytelling" and part number

이미지 추출 및 본문 섹션을 구조화된 마크다운으로 변환하는 핵심 프롬프트

변환 과정에서 발생한 마크다운 내부 링크 오류와 거대한 이미지 크기 문제를 Claude Code의 추가 명령을 통해 즉각적으로 해결했습니다. HTML 앵커 링크를 사용하여 문서 내 이동을 최적화하고 이미지 크기를 50%로 일괄 축소하는 등 후처리 작업을 자동화했습니다. 최종적으로 모든 마크다운 파일을 병합하고 EPUB 포맷으로 변환하여 모바일 기기 가독성을 확보한 결과물을 얻었습니다.
Claude Code를 통해 변환된 마크다운 문서가 노션(Notion) 스타일의 인터페이스에 정리된 모습이다.
ScreenshotPDF의 복잡한 구조가 YAML 헤더, 목차, 섹션별 헤더로 깔끔하게 변환되었음을 보여준다. 저자가 프롬프트를 통해 의도한 'The Lessons' 링크 구조와 이미지 포함 결과가 실제 소프트웨어 상에서 어떻게 구현되었는지 시각적으로 증명한다.

용어 해설

클로드 코드(Claude Code)
Anthropic에서 개발한 CLI 기반의 에이전틱 코딩 도구이다. 터미널 환경에서 직접 파일 시스템에 접근하여 코드를 작성, 수정, 실행하고 복잡한 워크플로를 자동화하는 기능을 제공한다.
야멜(YAML)
데이터 직렬화 양식의 하나로, 사람이 읽기 쉬운 구조를 가진다. 마크다운 문서의 상단(Frontmatter)에서 제목, 저자, 날짜 등의 메타데이터를 정의하는 데 널리 사용된다.
할루시네이션(Hallucination)
대형 언어 모델이 학습 데이터에 없는 내용을 사실인 것처럼 그럴듯하게 생성해내는 현상이다. 정교하지 않은 프롬프트나 복잡한 구조의 데이터를 처리할 때 발생 가능성이 높아진다.
명령 줄 인터페이스(CLI)
텍스트 터미널을 통해 사용자가 컴퓨터와 상호작용하는 방식이다. 그래픽 인터페이스(GUI)보다 자동화와 스크립트 처리에 유리하여 개발자나 시스템 관리자가 선호하는 환경이다.
이펍(EPUB)
국제 디지털 출판 포럼에서 제정한 개방형 전자책 표준 포맷이다. 화면 크기에 따라 텍스트가 유동적으로 재배치되는 리플로우(Reflow) 기능을 지원하여 다양한 모바일 기기에서 읽기에 최적화되어 있다.

기술

  • Claude Code
  • Claude Pro
  • Markdown
  • YAML
  • EPUB

활용 사례

  • PDF 강의 노트를 마크다운으로 변환
  • 전자책(EPUB) 제작 자동화
  • 문서 메타데이터(YAML) 자동 추출

언급된 리소스

AI 분석 전체 내용 보기

AI 요약 · 북마크 · 개인 피드 설정 — 무료

출처 · 인용 안내

원문 발행 2026. 03. 25.수집 2026. 03. 25.출처 타입 RSS

인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.