EBOOKEPUBPDFPREP

ChatGPT·Claude로 쓰고 코드로 찍는 전자책

주제 한 줄에서 EPUB·PDF까지, AI와 코드로 만드는 전자책

AI로 목차와 초고를 만들고, 다이어그램 생성부터 EPUB·PDF 조판까지 자동화하는 전자책 제작 전 과정을 다루는 한국어 실전서. 3장까지 읽으면 첫 전자책 파일이 나온다. EPUB+PDF 제공, 개정판 무료.

구매 준비 중입니다. 아래 목차·샘플은 출간 준비 중인 판이며, 정식 출간 시 최종 원고로 교체될 수 있습니다.

ChatGPT·Claude로 쓰고 코드로 찍는 전자책
§01 / OVERVIEW

소개

책 한 권 분량의 주제를 가진 사람이 그것을 전자책으로 만들지 못하는 이유는 두 곳에 있습니다. 앞에서는 원고가 끝까지 나오지 않고, 뒤에서는 그 마크다운 더미를 팔 수 있는 파일로 바꾸는 구간에서 그림과 판형과 한글 조판이 차례로 무너집니다. 이 책은 그 양쪽을 모두 자동화합니다 — 주제 한 줄에서 시작해 AI와 함께 목차를 잡고 초고를 쓰고, 그 원고 폴더를 명령 한 줄로 EPUB과 PDF로 굽는 로컬 파이프라인을 처음부터 끝까지 만듭니다.

3장까지 읽으면 이미 전자책 파일이 손에 있습니다. 코드 없이 도구만으로 만드는 투박한 버전이고, 그 투박함이 나머지 장에서 무엇을 만들지를 정확히 알려 줍니다. 이후 각 장은 그 흐름의 한 단계씩을 제대로 바꿔 갑니다 — AI 집필 절차, 다이어그램 자동 생성과 자기교정, 디자인 토큰, 두 판형 조판, 여러 권 배치, 미리보기와 검증까지.

설명은 실제로 부딪힌 실패에서 나왔습니다. 코드 블록이 2단 보기에서만 잘리는 이유, 한글 축 라벨이 두부로 나오는 원인, 표지에 다른 책 부제가 새어 들어가는 경로 — 빌드가 성공한 채로 조용히 잘못되는 지점들과 그것을 잡는 검증 절차를 순서대로 정리했습니다. 본문의 도식 18개도 전부 원고 안에 코드로 들어 있고, 이 책 자체가 그 파이프라인으로 조판됐습니다.

§02 / FEATURES

주요 기능

AI로 원고를 완성하는 절차

주제 한 줄을 약속 문장·독자 정의·장 브리프로 바꾸고, 장별 집필 세션을 도는 여섯 블록 프롬프트 틀까지 그대로 씁니다. AI 초고의 전형적 실패 네 가지와, 코드·수치를 기계로 검증하는 습관을 함께 다룹니다.

3장에서 나오는 첫 결과물

코드를 쓰기 전에 도구만으로 EPUB과 PDF를 먼저 만듭니다. 한글 PDF에 필요한 최소 옵션과 막히는 지점 표까지 포함되어, 자기 환경에서 되는지를 먼저 확인하고 나머지를 읽을 수 있습니다.

다이어그램을 코드로 다루기

그림을 이미지가 아니라 Mermaid·D2·Vega-Lite 코드로 원고에 씁니다. 자연어 설명만 쓰면 LLM이 코드를 만들고, 렌더에 실패하면 파서 에러를 다시 넣어 스스로 고치는 자기교정 루프까지 구현합니다.

AI 이미지 생성은 언제 쓰는가

표지·삽화에 이미지 생성 모델과 디자인 도구를 쓸지 판단하는 기준, 비용 구조, 한글 텍스트를 이미지에 맡기면 안 되는 이유, 해상도·라이선스 확인 항목을 정리합니다.

한글 조판 함정 해결

코드 블록이 잘리는 두 원인, 표 폭 균일화 필터, 러닝 헤더와 속표지가 죽는 지점, 폰트 임베드 실측까지 — 증상과 원인의 거리가 먼 문제들을 해결 순서 그대로 담았습니다.

여러 권 운영과 배포 전 검증

원고 폴더 하나가 책 한 권이 되는 배치 빌드, 무료 미리보기와 목차 데이터 자동 생성, 그리고 빌드가 성공한 채로 잘못되는 경우를 잡아내는 네 단계 검증과 체크리스트를 만듭니다.

§03 / HOW IT WORKS

작동 방식

  1. 01

    샘플 챕터 확인

    구매 전 앞 2개 장을 HTML·PDF로 무료로 미리 볼 수 있습니다. 왜 이 방식인지와 도구 설치까지 확인한 뒤 판단하세요.

  2. 02

    구매

    1회 결제로 EPUB과 PDF를 모두 받습니다. 결제는 토스페이먼츠로 진행되며, 카드·간편결제는 승인 즉시 서재에 담깁니다. 입금 시점에 정산되는 가상계좌(무통장 입금)는 아직 지원하지 않으니 카드·간편결제를 이용해 주세요.

  3. 03

    내 서재에서 다운로드

    결제 완료 즉시 내 서재에서 EPUB·PDF를 다운로드합니다. 개정판이 나오면 같은 서재에서 다시 받을 수 있습니다.

§04 / PRICING

요금제

Recommended전자책
₩29,000

1회 결제 · 소장

  • EPUB + PDF 동시 제공
  • 개정판 무료 재다운로드
  • 구매 즉시 내 서재에서 다운로드
  • 샘플 챕터 무료 미리보기

1회 결제로 EPUB·PDF를 모두 받고, 개정판은 무료로 다시 받습니다. 다운로드 개시 후에는 청약철회가 제한됩니다.

§05 / CONTENTS

목차

  • 1. 주제 하나에서 전자책 두 판형까지
  • 1.1. 수작업 조판이 무너지는 세 지점
  • 1.2. 이 책의 원칙: diagram-as-code
  • 1.3. 만들 물건
  • 1.4. 도구 선택
  • 1.5. 누구를 위한 책인가
  • 1.6. 이 책을 읽는 법
  • 1.7. 이 책이 다루지 않는 것
  • 2. 도구 체인 준비
  • 2.1. 무엇을 왜 까는가
  • 2.2. 폰트: 이름 하나가 전부를 정한다
  • 2.3. 점검 스크립트
  • 2.4. 프로젝트 뼈대
  • 2.5. 환경 변수
  • 2.6. 점검
  • 3. 30분 빠른 시작
  • 3.1. 폴더 만들기
  • 3.2. EPUB 만들기
  • 3.3. PDF 만들기
  • 3.4. 여기서 막힌다면
  • 3.5. 무엇이 부족한가
  • 3.6. 이 장에서 만든 것
  • 4. 주제에서 목차로
  • 4.1. 왜 목차가 먼저인가
  • 4.2. 약속 문장부터
  • 4.3. 독자를 좁힌다
  • 4.4. 목차 생성 프롬프트
  • 4.5. 목차를 검증한다
  • 4.6. 장 브리프
  • 4.7. 목차가 바뀔 때
  • 5. AI로 초고 쓰기
  • 5.1. 한 세션에 한 장
  • 5.2. 집필 프롬프트의 구조
  • 5.3. AI 초고의 전형적 실패
  • 5.4. 사실은 기계로 검증한다
  • 5.5. 도구를 나눠 쓴다
  • 5.6. 초고를 초고로 취급한다
  • 5.7. AI 사용 고지
  • 5.8. 이 장에서 만든 것
  • 6. 원고 규약과 정규화
  • 6.1. 디렉터리 구조
  • 6.2. 제목 규칙
  • 6.3. 콜아웃
  • 6.4. 코드와 표
  • 6.5. 다이어그램 블록
  • 6.6. 정규화 코드
  • 6.7. 정규화를 어디에 둘 것인가
  • 6.8. 이 장에서 정한 것
  • 7. 오케스트레이터 뼈대
  • 7.1. 다섯 단계
  • 7.2. 경로와 설정을 한 곳에
  • 7.3. 책의 메타데이터
  • 7.4. 책 한 권의 명세
  • 7.5. 빌드 함수
  • 7.6. 명령줄 인자
  • 7.7. 실행
  • 7.8. 이 장에서 만든 것
  • 8. 다이어그램을 코드로
  • 8.1. 다섯 가지 블록
  • 8.2. 블록을 찾아낸다
  • 8.3. 정보 문자열 파싱
  • 8.4. 왜 플레이스홀더인가
  • 8.5. 추출 구현
  • 8.6. 판형별 치환
  • 8.7. 그림 크기는 종횡비가 정한다
  • 8.8. 이 장에서 만든 것
  • 9. 자연어에서 다이어그램 코드로
  • 9.1. 챗이 아니라 API다
  • 9.2. 얇은 모듈로 격리한다
  • 9.3. 모델을 둘로 나눈다
  • 9.4. 프롬프트
  • 9.5. 코드펜스는 어차피 온다
  • 9.6. 호출 흐름
  • 9.7. 비결정성과 캐시
  • 9.8. 비용
  • 9.9. 이 장에서 만든 것
  • 10. 자기교정 루프
  • 10.1. 실패는 예외가 아니라 값이다
  • 10.2. 에러를 정제한다
  • 10.3. 교정 프롬프트
  • 10.4. 종류별 힌트
  • 10.5. 루프
  • 10.6. 무엇이 남는가
  • 10.7. 이 장에서 만든 것
  • 11. 렌더러 실전
  • 11.1. 캐시부터
  • 11.2. Mermaid
  • 11.3. D2: 두 번의 우회
  • 11.4. Vega-Lite: 브라우저 없는 렌더
  • 11.5. 디스패치
  • 11.6. 왜 EPUB에는 PNG인가
  • 11.7. 이 장에서 만든 것
  • 12. 그림을 조달하는 방법
  • 12.1. 세 가지 조달 경로
  • 12.2. AI 이미지 생성: 언제 쓰는가
  • 12.3. 도구 선택지
  • 12.4. 비용은 사용자의 선택이다
  • 12.5. 파이프라인에 넣기
  • 12.6. 인쇄 품질 요구
  • 12.7. 확인할 것
  • 12.8. 어떻게 나누는가
  • 12.9. 이 장에서 정리한 것
  • 13. 디자인 토큰
  • 13.1. 토큰 파일
  • 13.2. 파생색: 토큰을 늘리지 않고 변형한다
  • 13.3. 산출물 하나씩
  • 13.4. 표지를 코드로
  • 13.5. PDF 속표지와 시각 언어 공유
  • 13.6. 무엇이 남았나
  • 13.7. 이 장에서 만든 것
  • 14. EPUB 조판
  • 14.1. 조판 명령
  • 14.2. EPUB 안에 뭐가 들었나
  • 14.3. 콜아웃 필터
  • 14.4. 코드 블록: 가장 비싸게 배운 함정
  • 14.5. 한글 줄바꿈
  • 14.6.
  • 14.7. 검증
  • 14.8. 이 장에서 만든 것
  • 15. PDF 조판
  • 15.1. 조판 명령
  • 15.2. 프리앰블
  • 15.3. 코드 줄바꿈
  • 15.4. 표 폭
  • 15.5. URL
  • 15.6. 러닝 헤더
  • 15.7. 속표지
  • 15.8. 그림 배치 다시 보기
  • 15.9. 검증
  • 15.10. 이 장에서 만든 것
  • 16. 여러 권을 한 번에
  • 16.1. 규칙: 하위 디렉터리 하나가 책 한 권
  • 16.2. 슬러그: 한글 폴더 이름 다루기
  • 16.3. 책별 메타데이터
  • 16.4. 실패를 가둔다
  • 16.5. 단수형 인자를 거부한다
  • 16.6. 상태 누수 다시 보기
  • 16.7. 캐시는 공유한다
  • 16.8. 실행
  • 16.9. 이 장에서 만든 것
  • 17. 미리보기와 목차 데이터
  • 17.1. 미리보기: 몇 장까지 열 것인가
  • 17.2. 미리보기 빌드
  • 17.3. 자체 완결 HTML
  • 17.4. 목차 데이터
  • 17.5. 데이터 형식은 계약이다
  • 17.6. 산출물 정리
  • 17.7. 이 장에서 만든 것
  • 18. 검증 절차
  • 18.1. 1단계: 표준 검사
  • 18.2. 2단계: PDF 페이지 눈검사
  • 18.3. 3단계: EPUB 실제 렌더 확인
  • 18.4. 4단계: 메타·목차 대조
  • 18.5. 캐시 무효화
  • 18.6. 배포 전 체크리스트
  • 18.7. 개정판을 위한 기록
  • 18.8. 이 장에서 만든 것
  • 19. 마치며
  • 19.1. 무엇이 남았는가
  • 19.2. AI가 한 일과 하지 않은 일
  • 19.3. 여기서 더 나갈 수 있는 곳
  • 19.4. 마지막
§06 / PLATFORM

플랫폼 · 요구사항

판형
EPUB3 (리플로우) + PDF (고정 레이아웃, 벡터 다이어그램)
다운로드
개인 식별 워터마크 삽입 — 계정별 재발급 가능
리더 호환
Apple Books · Kindle(변환) · Adobe Acrobat 등 표준 EPUB3/PDF 리더
언어
한국어
§07 / WHY

차별점

    §08 / FOR

    이런 분께

    쌓아 둔 글이나 강의 자료를 전자책으로 내고 싶은 1인 저자터미널과 마크다운은 쓸 줄 아는, 전자책 출판이 처음인 실무자AI로 원고를 쓰되 검증 가능한 결과물로 만들고 싶은 사람다이어그램이 많은 기술 문서를 반복 가능한 방식으로 조판하려는 개발자
    §09 / FAQ

    자주 묻는 질문

    환불이 되나요?

    아직 한 번도 다운로드하지 않으셨다면 결제일로부터 7일 이내에 청약철회(전액 환불)를 신청하실 수 있습니다. 다운로드가 시작된 뒤에는 콘텐츠 특성상 청약철회가 제한됩니다(전자상거래법 제17조). 다운로드 여부는 서재의 다운로드 기록으로 판정합니다.

    환불은 어떻게 신청하나요?

    사이트에 환불 버튼은 없습니다. 문의하기로 결제일·주문번호·환불 사유를 보내 주시면 담당자가 직접 확인한 뒤 토스페이먼츠에서 결제 수단으로 환불해 드립니다. 접수 후 3영업일 이내에 검토 결과를 안내하고, 승인되면 영업일 기준 3~5일 내에 환불됩니다. 참고로 환불이 끝난 책은 결제 시스템 구조상 같은 계정에서 다시 결제할 수 없으니, 나중에 재구매를 원하시면 문의로 안내해 드립니다.

    가상계좌(무통장 입금)로 결제할 수 있나요?

    지금은 지원하지 않습니다. 가상계좌는 입금이 확인된 뒤에야 결제가 완료되는데, 아직 입금 확인 처리가 준비되지 않아 이용 권한이 바로 발급되지 않습니다. 카드·간편결제로 결제해 주세요.

    개정판은 유료인가요?

    아니요. 한 번 구매하면 이후 나오는 개정판을 내 서재에서 무료로 다시 받을 수 있습니다.

    워터마크가 들어가나요?

    네. 다운로드하는 EPUB·PDF 파일에 구매자 식별 정보가 워터마크로 삽입됩니다. 개인 학습·소장 목적의 열람에는 지장이 없으며, 무단 재배포 방지를 위한 조치입니다.

    어떤 리더에서 볼 수 있나요?

    표준 EPUB3를 지원하는 Apple Books 등 대부분의 리더에서 바로 열립니다. Kindle은 자체 변환이 필요할 수 있고, PDF는 Adobe Acrobat 등 일반 PDF 리더에서 바로 볼 수 있습니다.

    프로그래밍을 몰라도 따라 할 수 있나요?

    터미널에서 명령을 실행하고 마크다운으로 글을 써 본 정도면 됩니다. 본문의 코드는 그대로 복사해 쓸 수 있는 완성된 형태라 파이썬을 직접 작성할 필요는 없습니다. LaTeX이나 EPUB 내부 구조 지식은 필요하지 않습니다.

    윈도우에서도 되나요?

    설명과 설치 명령은 macOS 기준입니다. 사용하는 도구(pandoc·xelatex·mermaid-cli·d2)는 모두 크로스 플랫폼이라 설치 방법만 바꾸면 리눅스에서는 그대로 동작하고, 윈도우는 WSL 사용을 권합니다.

    AI API 키가 꼭 필요한가요?

    없어도 책은 만들어집니다. 자연어로 쓴 다이어그램 블록만 건너뛰고 나머지가 그대로 빌드되도록 설계되어 있습니다. 다이어그램 코드를 직접 쓰거나 AI에게 받아 붙여 넣는 방식으로도 전 과정을 진행할 수 있습니다.

    비용이 얼마나 드나요?

    조판 도구는 모두 무료이고 빌드는 로컬에서 돕니다. 비용이 생기는 곳은 AI 호출 두 군데뿐입니다 — 원고 집필과 다이어그램 코드 생성이며, 후자는 저가 모델로 책 한 권에 소액입니다. AI 이미지 생성은 장당 과금이라 12장에서 별도로 다루고, 쓰지 않아도 완결된 책이 나옵니다.

    §10 / DOCS

    문서 · 링크