PDF 딸깍 사용 설명서v1.0.0
PDF 편집·조작 전용 24개 앱 — 자르기·붙이기·추출·병합·번역·요약·뷰어 hub. 모두 한 번의 동작으로 결과가 나오는 한국어 친화 디자인.
1. PDF 딸깍 이란?
PDF 딸깍은 일상에서 자주 만나는 PDF 작업을 한 번의 동작 으로 끝내려고 만든 도구 모음입니다. 별도 설치 없이 브라우저에서 바로 사용. 파일은 대부분 사용자 PC 안 에서 처리되고, AI 가 필요한 도구만 API 호출.
- 한 번의 동작: 파일 드롭 → 결과 다운로드까지 클릭 최소화
- 한국어 친화: UI 한글, 한국식 페이지번호 포맷 (1쪽, -1-, 1/10 등), 한글 폰트 자동 임베드
- 도구별 독립: 각 도구 페이지가 자체 완결 — 뭘 쓸지 결정 → 카드 클릭 → 그 도구만 사용
- 딸깍 개발실의 다른 앱과 연결: PDF → MD 출력 zip 을 한글 문서 스타일 딸깍 (md2hwpx) 에 바로 던지면 한컴 HWPX 양식까지 직행
v1.0.0 의 큰 줄기
- ✅ 24개 도구 + PDF 뷰어 hub (페이지 작업 8 + 콘텐츠 편집 6 + 추출·변환 4 + 기타 6 = 카탈로그 24)
- ✅ nodejs 백엔드: PDF 잠금 풀기 (muhammara), DeepL 번역 proxy, 헬스 체크 = `/api/*`
- ✅ Cloudflare Worker: Replicate Marker (PDF→MD, PDF 번역 paragraph + bbox), 업스케일, OCR 등
- ✅ 한글 폰트 자동 임베드: 워터마크·텍스트 추가·번역 결과에 나눔고딕·나눔명조 자동
2. 빠른 시작
PDF 딸깍 홈 (../) 에 들어가면 24개 도구가 4 카테고리로 그리드 노출. 카테고리:
- 페이지 작업 — 페이지 단위 조작 (병합·분할·회전·삭제·재정렬·추출·크기·자르기)
- 콘텐츠 편집 — PDF 안에 새 콘텐츠 추가 (워터마크·페이지번호·머리글·텍스트·서명)
- 추출·변환 — PDF ↔ 다른 포맷 (텍스트·이미지·마크다운)
- 기타 도구 — 뷰어 hub·비교·압축·잠금풀기·AI 요약·번역
대부분의 도구가 같은 패턴: 드롭존에 PDF 드래그 (또는 클릭 → 파일 선택). 파일은 브라우저 메모리에서 처리, 서버로 안 올라감 (잠금풀기·DeepL 번역·Marker AI 등 백엔드 호출 도구는 예외 — 그때만 전송).
옵션은 한국어로 라벨링, 기본값이 보통 합리적. "적용" 또는 "실행" 버튼 누르면 결과 PDF/zip 자동 다운로드. 진행률 띠가 위에 표시됨.
익숙해지는 가장 빠른 길은 PDF 뷰어 에 PDF 한 번 드롭해보는 것. 좌측 미리보기로 PDF 살펴보면서 우측 사이드바의 도구 목록을 한눈에 볼 수 있음.
3. PDF 뷰어 (hub)
📂 PDF 뷰어 는 PDF 를 살펴보고 어떤 도구가 필요한지 결정할 수 있는 진입점입니다.
현재 v1.0.0 — MVP
- 좌측: PDF 모든 페이지 미리보기 (pdf.js lazy 렌더링). 줌 (50~300%) · 너비 맞춤 토글 · 페이지 번호 표시
- 우측 사이드바: 23개 도구 카테고리별 카드 — 클릭하면 새 탭에서 그 도구 열림
현재 뷰어는 단순 미리보기 + 외부 도구 링크입니다. v2.0 에서 일반 PDF 뷰어 기능 (텍스트 선택·복사·Ctrl+F 검색·이미지 복사) + 23개 도구를 뷰어 안 inline 작동으로 확장 예정. 기존 도구 페이지는 모두 그대로 유지됩니다 (뷰어와 단독 페이지 둘 다 지원).
지금 권장 패턴
- PDF 뷰어에 PDF 드롭 → 좌측 미리보기로 내용 확인
- 우측 사이드바에서 원하는 도구 클릭 (새 탭)
- 새 탭의 도구 페이지에 같은 PDF 다시 드롭 → 작업 진행
4. 도구 24개
4-1. ● 페이지 작업 (8)
4-2. ● 콘텐츠 편집 (6)
4-3. ● 추출·변환 (4)
PDF → MD 결과 zip (`.md` + `images/`) 을 그대로 한글 문서 스타일 딸깍 (md2hwpx) 에 던지면 이미지 자동 임베드된 .hwpx 까지 한 번에. 정부 PDF 보고서 → 한컴 워크플로 매끄럽게 연결됨.
4-4. ● 기타 도구 (6)
5. AI 도구 키 등록
AI 호출 도구 (요약·번역·PDF→MD) 는 API 키가 필요합니다. 키는 사용자 브라우저에만 저장 (서버로 안 보냄). 모든 PDF 딸깍 도구가 같은 저장소 공유.
등록 방법
- PDF 딸깍 홈 또는 도구 페이지 우측 상단 [API 설정] 버튼 클릭
- 모달에서 키 종류 선택 + 키 값 입력 → [💾 저장]
- 모든 도구에 즉시 반영 (페이지 새로고침 X)
지원 키
| 키 | 도구 | 비용 | 발급 |
|---|---|---|---|
| Gemini | 요약, 번역 (Gemini 엔진), PDF→MD (Gemini 옵션) | 무료 티어 충분 (분당 15회) | Google AI Studio |
| DeepL | 번역 (DeepL 엔진, 기본 추천) | Free 50만자/월 무료 (키 끝 :fx) | DeepL API |
| Replicate Worker URL | PDF→MD (Marker), PDF 번역 (Marker 모드) | 기본 Worker (제공자 부담) | 기본값 자동 사용 |
요약·번역만 쓴다면 Gemini 키만 등록해도 충분 (둘 다 작동). DeepL 키도 등록해두면 번역 품질 비교 가능 (전문 문서·유럽어 ↔ 한국어 자연스러움 ↑).
6. 추천 워크플로
1) 정부 보도자료 PDF → 한컴 한글 보고서
- 📄 PDF → MD 에 PDF 드롭 → Marker balanced 모드 → .zip 다운로드 (md + images/)
- 한글 문서 스타일 딸깍 에 같은 .zip 통째로 드롭
- 이미지 자동 임베드된 .hwpx 다운로드 → 한컴에서 열기
2) 외국어 PDF 보고서 → 한국어 번역본
- 🌐 PDF 번역 에 PDF 드롭
- 추출 모드 = Marker AI (paragraph + bbox, 정확) — 기본값
- 번역 엔진 = DeepL 또는 Gemini — 기본 DeepL
- 도착 언어 = 한국어 → 번역 시작
- ~수 분 후 원본 레이아웃 위 한국어 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 호출 도구 (잠금풀기, DeepL 번역, Marker AI = PDF→MD/번역) 는 그때만 백엔드/Worker 로 전송. 사용자 PDF 가 서버에 영구 저장 X, API 키 마스킹 처리.
Q. 결과 PDF 가 한컴에서 안 열려요
대부분 잠금/암호화 잔존이 원인. 잠금 풀기 한 번 거친 뒤 다시 시도. 그래도 안 되면 PDF 자체가 비표준 구조 — pdfcandy / Adobe Acrobat 으로 일회 normalize 권장.
Q. 한글이 깨져요
워터마크/텍스트 추가/번역 결과는 나눔고딕·나눔명조 가 자동 임베드돼 한컴/Adobe 모두 정상 표시. 만약 깨지면 그 도구의 폰트 옵션에서 다른 한글 폰트 선택해보세요.
Q. API 키 없어도 쓸 수 있나요?
네. 20개 도구는 키 없이 100% 작동. 키가 필요한 건 AI 도구 4개 — PDF→MD, PDF 요약, PDF 번역 (Gemini/DeepL 옵션). Marker AI 옵션 (PDF→MD, PDF 번역) 은 기본 Worker URL 자동 사용이라 사용자 키 등록 X.
Q. v2.0 은 언제 나오나요?
v2.0 = PDF 뷰어 hub 풀 리팩토링 (일반 뷰어 기능 + 23개 도구 inline 작동). 23개 도구 패널 모듈화 + 공유 PDF 인스턴스 작업이 큼 (수일~수주 분량). 기존 23개 도구 단독 페이지는 모두 그대로 유지됩니다. 별도 세션에서 점진 진행 예정 (자세한 계획은 PATCHNOTE.md 의 v2.0 섹션 참조).
Q. 다른 한국어 도구는?
같은 딸깍 개발실 에 슬라이드 이미지 수정 딸깍, 한글 문서 스타일 딸깍 (md2hwpx), 주간정책동향 딸깍 (WeeklyBrief) 가 있어요. 모두 한국어 친화, '딸깍' 디자인 원칙 공유.
- 개발 문서 (dev.md) — 도구 24개 카탈로그·코어 모듈 11개·Phase 1~5 회고
- 패치 노트 (PATCHNOTE.md) — v0.0.0 ~ v1.0.0 + v2.0 계획
- 루트 README — 딸깍 개발실 전체 앱 소개