PDF 딸깍 사용 설명서v1.0.0

PDF 편집·조작 전용 25개 앱 + PDF 뷰어 v2.0 (3-column 편집기, 18개 도구 inline). v1.2.0 — 2026-05-26 정식 출시

1. PDF 딸깍 이란?

PDF 딸깍은 일상에서 자주 만나는 PDF 작업을 한 번의 동작 으로 끝내려고 만든 도구 모음입니다. 별도 설치 없이 브라우저에서 바로 사용. 파일은 대부분 사용자 PC 안 에서 처리되고, AI 가 필요한 도구만 API 호출.

💡 핵심 약속

한 번의 동작: 파일 드롭 → 결과 다운로드까지 클릭 최소화
한국어 친화: UI 한글, 한국식 페이지번호 포맷 (1쪽, -1-, 1/10 등), 한글 폰트 자동 임베드
도구별 독립: 각 도구 페이지가 자체 완결 — 뭘 쓸지 결정 → 카드 클릭 → 그 도구만 사용
딸깍 개발실의 다른 앱과 연결: PDF → MD 출력 zip 을 한글 문서 스타일 딸깍 (md2hwpx) 에 바로 던지면 한컴 HWPX 양식까지 직행

v1.0.0 의 큰 줄기

✅ 25개 도구 + PDF 뷰어 v2.0 편집기 (페이지 작업 8 + 콘텐츠 편집 6 + 추출·변환 5 + 기타 6 = 카탈로그 25). 뷰어 안에서 18개 inline 작동
✅ nodejs 백엔드: PDF 잠금 풀기 (muhammara), Replicate proxy, 헬스 체크 = `/api/*`
✅ Cloudflare Worker: Replicate Marker (PDF→MD, PDF 번역 paragraph + bbox), 업스케일, OCR 등
✅ 한글 폰트 자동 임베드: 워터마크·텍스트 추가·번역 결과에 나눔고딕·나눔명조 자동

2. 빠른 시작

1홈 카탈로그에서 도구 고르기

PDF 딸깍 홈 (../) 에 들어가면 24개 도구가 4 카테고리로 그리드 노출. 카테고리:

페이지 작업 — 페이지 단위 조작 (병합·분할·회전·삭제·재정렬·추출·크기·자르기)
콘텐츠 편집 — PDF 안에 새 콘텐츠 추가 (워터마크·페이지번호·머리글·텍스트·서명)
추출·변환 — PDF ↔ 다른 포맷 (텍스트·이미지·마크다운)
기타 도구 — 뷰어 hub·비교·압축·잠금풀기·AI 요약·번역

2PDF 를 드래그/드롭 또는 클릭

대부분의 도구가 같은 패턴: 드롭존에 PDF 드래그 (또는 클릭 → 파일 선택). 파일은 브라우저 메모리에서 처리, 서버로 안 올라감 (잠금풀기·Marker AI 등 백엔드 호출 도구는 예외 — 그때만 전송).

3옵션 선택 → 결과 다운로드

옵션은 한국어로 라벨링, 기본값이 보통 합리적. "적용" 또는 "실행" 버튼 누르면 결과 PDF/zip 자동 다운로드. 진행률 띠가 위에 표시됨.

💡 첫 사용 팁

익숙해지는 가장 빠른 길은 PDF 뷰어 에 PDF 한 번 드롭해보는 것. 좌측 미리보기로 PDF 살펴보면서 우측 사이드바의 도구 목록을 한눈에 볼 수 있음.

3. PDF 뷰어 v2.0 (3-column PDF 편집기) ★

📂 PDF 뷰어 는 v1.2.0 부터 단순 hub 가 아닌 본격 PDF 편집기입니다. 18개 도구를 viewer 안에서 inline 작동, ↶ Undo 로 단계별 복원, 💾 다운로드 한 번에 누적 결과.

3-column 레이아웃

좌측 (220px): 썸네일 + 체크박스 (페이지 선택용). 전체 선택 토글
중앙 (1fr): lazy 페이지 미리보기 + TextLayer (텍스트 드래그 선택 → Ctrl+C 복사). 줌 (50~300%) / 너비 맞춤
우측 (320px): 18개 도구 카테고리별 카드. 클릭 = 패널 오버레이 swap, "← 도구 목록" 으로 복귀

메인 toolbar (상단 가로)

📄 파일명 · 페이지 수
🔍 줌 / 너비 맞춤
↶ Undo (Ctrl+Z) / ↷ Redo (Ctrl+Shift+Z) — 각 도구 적용을 history stack 에 push
🖨️ 인쇄 — 누적 결과 PDF 를 브라우저 인쇄 다이얼로그
💾 다운로드 — 누적 결과 한 번에 ("xxx-편집됨.pdf")
📂 다른 PDF

도구 분류 (panel 인 18개)

카테고리	도구
페이지 작업 (5 즉시 적용)	🔄 회전·반전 · 🗑️ 페이지 삭제 · ↔️ 재정렬 (드래그) · 📐 크기 조정 · ✂️ 자르기 (WYSIWYG)
페이지 작업 (2 결과 반환)	📤 페이지 추출 · ✂️ 분할 (분할점/each/group)
콘텐츠 편집 (5 즉시 적용)	🔢 페이지 번호 · 💧 워터마크 텍스트 · 🖼️ 워터마크 이미지 · 📋 머리바닥글 · ✏️ 텍스트 추가
추출·변환 (4 결과 반환)	📝 텍스트 추출 (다국어 분리) · 🖼️ 페이지→이미지 · 🎨 이미지 추출 · 📄 PDF→MD
기타 (2)	🔓 잠금 풀기 · 📦 이미지 압축

💡 일부 도구는 단독 페이지만

다음 6개는 정교한 UI (마우스 그리기·다중 입력·Mermaid·bbox overlay) 가 viewer 사이드바 부적합 → 단독 페이지에서 사용:

✍️ 서명 · 📑 병합 · 📷 이미지→PDF · ⚖️ PDF 비교 · ✨ PDF 요약 · 🌐 PDF 번역

PDF 딸깍 카탈로그 (`/pdftools/`) 카드는 모두 그대로 노출됩니다.

권장 워크플로 (v1.2.0+)

PDF 뷰어에 PDF 드롭
좌측에서 적용할 페이지 선택 (또는 전체)
우측 도구 클릭 → 옵션 입력 → 적용 (즉시 viewer 반영)
다른 도구 또 적용 = 누적
↶ Undo 로 단계별 복원, 또는 💾 다운로드로 최종 결과

4. 도구 24개

4-1. ● 페이지 작업 (8)

📑 병합

여러 PDF 를 하나로 묶기. 드래그로 순서 조정. 열기

✂️ 분할

1개 PDF → 여러 개. 페이지/범위/N장씩 분할 모드 선택. 열기

🔄 회전·반전

90/180/270° 회전 + 좌우/상하 반전. 페이지별 선택 가능. 열기

🗑️ 페이지 삭제

필요 없는 페이지 빼기. 썸네일 클릭 선택. 열기

↔️ 페이지 재정렬

드래그로 페이지 순서 바꾸기. 열기

📤 페이지 추출

특정 페이지만 빼서 새 PDF. 열기

📐 페이지 크기 조정

A4 / Letter / B5 등으로 통일. 열기

✂️ 자르기 (crop)

페이지 여백 잘라내기. 영역 드래그. 열기

4-2. ● 콘텐츠 편집 (6)

💧 워터마크 (텍스트)

"대외비" 등 한글 글자 워터마크. 9방향 위치 + 회전 각도. 열기

🖼️ 워터마크 (이미지)

로고·도장 이미지 워터마크 (PNG/JPG). 열기

🔢 페이지 번호

1쪽 / -1- / 1/10 등 한국식 포맷 + 사용자 정의. 열기

📋 머리글·바닥글

상단·하단 좌·중·우 6칸 + 페이지번호 변수. 열기

✏️ 텍스트 추가

빈 폼 PDF 에 클릭으로 텍스트 박스 (WYSIWYG 풀 에디터). 열기

✍️ 서명

마우스 그리기 + 이미지 업로드. 열기

4-3. ● 추출·변환 (4)

📝 텍스트 추출

PDF 텍스트 레이어 → .txt 다운로드. 열기

🖼️ 페이지 → 이미지

PDF 페이지 → JPG/PNG (DPI 선택, zip). 열기

📷 이미지 → PDF

이미지 여러 장 → PDF 1개 (페이지마다 한 장). 열기

📄 PDF → MD

Marker AI 가 PDF → 마크다운 변환 (표·수식·이미지 보존). 비용 ~6원/쪽. 열기

💡 PDF → MD → 한글 문서 워크플로

PDF → MD 결과 zip (`.md` + `images/`) 을 그대로 한글 문서 스타일 딸깍 (md2hwpx) 에 던지면 이미지 자동 임베드된 .hwpx 까지 한 번에. 정부 PDF 보고서 → 한컴 워크플로 매끄럽게 연결됨.

4-4. ● 기타 도구 (6)

📂 PDF 뷰어

미리보기 + 다른 도구 hub (v1.0.0 MVP). 열기

⚖️ PDF 비교

두 PDF 텍스트 페이지별 diff (표·이미지·레이아웃 X). 열기

📦 이미지 압축

PDF 안 JPEG 다운샘플로 용량 절감 (PNG 등은 건너뜀). 열기

🔓 잠금 풀기

권한 제한 PDF 자동 해제 (백엔드 muhammara). 비표준 PDF 는 pdfcandy/Adobe 안내. 열기

✨ PDF 요약

Gemini AI 자동 요약 + 🧬 온톨로지 + 📊 Mermaid 다이어그램. HTML/MD/TXT 다운로드. 열기

🌐 PDF 번역

Marker AI paragraph + bbox overlay · 원본 위 번역 새 PDF. Gemini. 열기

5. AI 도구 키 등록

AI 호출 도구 (요약·번역·PDF→MD) 는 API 키가 필요합니다. 키는 사용자 브라우저에만 저장 (서버로 안 보냄). 모든 PDF 딸깍 도구가 같은 저장소 공유.

등록 방법

PDF 딸깍 홈 또는 도구 페이지 우측 상단 [API 설정] 버튼 클릭
모달에서 키 종류 선택 + 키 값 입력 → [💾 저장]
모든 도구에 즉시 반영 (페이지 새로고침 X)

지원 키

키	도구	비용	발급
Gemini	요약, 번역, PDF→MD (Gemini 옵션)	무료 티어 충분 (분당 15회 · 멀티키 병렬)	Google AI Studio
Replicate Worker URL	PDF→MD (Marker), PDF 번역 (Marker 모드)	기본 Worker (제공자 부담)	기본값 자동 사용

💡 첫 사용 권장

요약·번역은 Gemini 키만 등록하면 됩니다. 추가 Gemini 키를 줄당 1개씩 넣으면 멀티키 병렬로 대용량 번역이 더 빠릅니다.

6. 추천 워크플로

1) 정부 보도자료 PDF → 한컴 한글 보고서

📄 PDF → MD 에 PDF 드롭 → Marker balanced 모드 → .zip 다운로드 (md + images/)
한글 문서 스타일 딸깍 에 같은 .zip 통째로 드롭
이미지 자동 임베드된 .hwpx 다운로드 → 한컴에서 열기

2) 외국어 PDF 보고서 → 한국어 번역본

🌐 PDF 번역 에 PDF 드롭
추출 모드 = Marker AI (paragraph + bbox, 정확) — 기본값
번역 엔진 = Gemini (무료 멀티키)
도착 언어 = 한국어 → 번역 시작
~수 분 후 원본 레이아웃 위 한국어 overlay 된 새 PDF 다운로드

3) 긴 PDF 문서 → 3분 요약 + 인포그래픽

✨ PDF 요약 에 PDF 드롭
출력 형식 = HTML (Mermaid 다이어그램 자동 렌더) 또는 MD/TXT
Gemini 가 4섹션 (개요·핵심·논점·결론) + 🧬 도메인 온톨로지 + 📊 논리 흐름 SVG 다이어그램
다운로드 받아 회의 자료로

4) 권한 제한 PDF (복사·인쇄 막힘) 해제

🔓 잠금 풀기 에 PDF 드롭 → 자동 처리 (백엔드 muhammara)
일반 권한 제한 PDF 는 즉시 해제 → 인쇄·복사·편집 가능한 새 PDF 다운로드
비표준 PDF (외국 발행 등) 실패 시 친절 에러 + Adobe Acrobat / pdfcandy 안내

7. 한계·주의사항

⚠ 알아둘 점

스캔 PDF: 텍스트 레이어 X 인 PDF 는 추출/번역/요약 도구가 빈 결과. PDF→MD (Marker) 의 force_ocr 옵션으로 먼저 텍스트화 후 작업 권장
열기 비밀번호 PDF: 파일 열기 자체에 비밀번호가 필요한 PDF 는 비밀번호 없이 풀 수 없음. 원본 비밀번호로 Adobe Acrobat 등에서 먼저 해제
비표준 권한 제한 PDF: 일부 외국 발행 PDF (한컴 ezPDF 외) 는 muhammara strict parser 가 fail. pdfcandy 같은 외부 도구로 일회 처리
PDF 번역 표 격자: Marker 가 표 셀의 children 을 안 줘서 격자 보존은 X (행 단위 줄바꿈만). 텍스트는 다 들어감
Marker 모드 비용: PDF→MD 와 PDF 번역의 Marker AI 옵션 = ~6원/쪽 (Replicate 비용, 기본 Worker 가 부담). 처리 시간 30초~수 분
회전·세로 텍스트: PDF 번역의 overlay 는 가로 텍스트만 (회전 텍스트는 원본 그대로 보존)

그룹웨어와 관계

PDF 딸깍은 GDI 그룹웨어 (더존 아마란스10 · 연구관리) 의 외부 독립 도구 입니다. 그룹웨어 본체는 IT 정책상 Extension·DOM 조작·iframe 등을 차단하므로, 본 도구는 그룹웨어 외부에서 작동 (파일 다운로드/업로드/클립보드 패턴만 사용).

8. FAQ

Q. 파일이 서버로 전송되나요?

대부분의 도구는 브라우저 메모리 안에서만 처리. AI 호출 도구 (잠금풀기, Marker AI = PDF→MD/번역) 는 그때만 백엔드/Worker 로 전송 (Gemini 번역은 추출 텍스트를 Google 로 직접 전송). 사용자 PDF 가 서버에 영구 저장 X, API 키 마스킹 처리.

Q. 결과 PDF 가 한컴에서 안 열려요

대부분 잠금/암호화 잔존이 원인. 잠금 풀기 한 번 거친 뒤 다시 시도. 그래도 안 되면 PDF 자체가 비표준 구조 — pdfcandy / Adobe Acrobat 으로 일회 normalize 권장.

Q. 한글이 깨져요

워터마크/텍스트 추가/번역 결과는 나눔고딕·나눔명조 가 자동 임베드돼 한컴/Adobe 모두 정상 표시. 만약 깨지면 그 도구의 폰트 옵션에서 다른 한글 폰트 선택해보세요.

Q. API 키 없어도 쓸 수 있나요?

네. 20개 도구는 키 없이 100% 작동. 키가 필요한 건 AI 도구 4개 — PDF→MD, PDF 요약, PDF 번역 (Gemini). Marker AI 옵션 (PDF→MD, PDF 번역) 은 기본 Worker URL 자동 사용이라 사용자 키 등록 X.

Q. PDF 뷰어 v2.0 은 어떻게 다른가요?

v1.2.0 (2026-05-26 출시) 으로 3-column PDF 편집기 완성. 좌 썸네일 · 중 lazy 페이지 (TextLayer 텍스트 선택) · 우 도구 18개 inline. 도구 옵션 = 즉시 currentCore 누적, ↶ Undo 로 복원, 💾 다운로드 한 번. 일부 도구 (서명·병합·요약·번역·이미지→PDF·PDF 비교) 는 정교한 UI 때문에 단독 페이지 강점 — viewer 사이드바에는 없고 PDF 딸깍 카탈로그에는 그대로.

Q. 다른 한국어 도구는?

같은 딸깍 개발실 에 슬라이드 이미지 수정 딸깍, 한글 문서 스타일 딸깍 (md2hwpx), 주간정책동향 딸깍 (WeeklyBrief) 가 있어요. 모두 한국어 친화, '딸깍' 디자인 원칙 공유.

📚 더 알아보기

개발 문서 (dev.md) — 도구 24개 카탈로그·코어 모듈 11개·Phase 1~5 회고
패치 노트 (PATCHNOTE.md) — v0.0.0 ~ v1.0.0 + v2.0 계획
루트 README — 딸깍 개발실 전체 앱 소개