파일 변환기 개발 기록 — 문서를 그림으로 저장할 때 잃는 것

9월 15일 사이트에 파일 변환기와 뷰어를 추가했습니다. 문서를 열어보고 다른 형식으로 내보내거나 PDF로 합치는 도구입니다. 이 글에서는 지원 확장자 수보다 중요한 변환 뒤 무엇이 유지되고 무엇이 달라지는지를 설명합니다.

읽기와 출력 사이에 공통 구조를 둡니다

한글·워드·표 문서·슬라이드는 파일 구조가 서로 다릅니다. 입력마다 미리보기와 출력 기능을 모두 별도로 만들면 같은 내용을 두 번 해석하기 쉽습니다. 이 도구는 읽은 내용을 공통 문서 DOM으로 모으고, 미리보기와 변환기가 그 구조를 활용하도록 나눴습니다.

출력 단계에서는 문단·제목·표·그림 같은 구조를 읽는 경로와 화면을 이미지로 만드는 경로가 갈립니다. 같은 내용을 내보내더라도 결과의 편집 가능성은 달라집니다.

PDF 병합과 PDF 변환은 다릅니다

직접 시험하려면 쉼표·따옴표가 든 CSV 검사의 작은 표로 시작하고, 변환 결과 확인 순서에 따라 사용 목적에 맞는 결과인지 확인하세요.

기존 PDF 페이지를 합칠 때는 페이지를 복사하는 방식이라 원본에 텍스트가 있으면 그 텍스트를 유지할 수 있습니다. 반면 다른 문서를 화면으로 렌더링한 뒤 PDF로 만드는 경로는 이미지 중심의 출력입니다. 원래 PDF가 스캔 이미지라면 병합한다고 글자가 선택 가능해지는 것도 아닙니다.

페이지 나눔은 원본과 같다고 약속하지 않습니다

브라우저는 워드나 한글 프로그램과 같은 조판 엔진이 아닙니다. 글꼴과 줄 높이, 표 배치가 달라지면 페이지가 나뉘는 위치도 달라질 수 있습니다. 이미지 출력의 페이지 분할 코드는 자를 위치 주변을 살펴 글자가 중간에서 잘리는 문제를 줄이려 합니다. 그렇다고 원본 문서의 페이지 배치를 완전히 재현한다는 뜻은 아닙니다.

파일 처리와 사이트 접속을 구분합니다

문서 읽기와 변환은 브라우저에서 수행하며 변환 라이브러리도 사이트 안에 두는 구조입니다. 다만 사이트를 여는 요청이나 예제 파일을 받는 요청까지 없다는 뜻은 아닙니다. 민감한 문서를 다룰 때는 네트워크 탭에서 파일 선택 전후의 요청을 구분해 확인하는 것이 좋습니다.

이번 글은 실제 개인 문서를 업로드하거나 외부로 보내며 검사한 기록이 아닙니다. 코드에는 예제 파일과 로컬 검증용 파일을 가져오는 요청이 있고, 사용자가 선택한 파일의 읽기·변환은 별도 경로로 구성돼 있음을 확인했습니다.

지원 표시와 호환성 검증은 구분합니다

프로젝트 기록에는 HWP 읽기를 실제 HWP 파일로 시험하지 못했고, HWPX·워드·PPT 출력을 실제 한글·오피스 프로그램으로 열어 확인하지 못한 범위가 명시돼 있습니다. 이 앱으로 다시 읽힌다는 것만으로 다른 프로그램에서도 동일하게 열린다고 단정하지 않습니다.

확인 근거는 사이트 커밋 f3df57e와 변환기의 공통 문서 구조·내보내기 코드, README의 검증 범위입니다. 중요한 문서라면 원본을 보관하고 목적 프로그램에서 결과를 직접 확인하세요. 파일 변환기 사용하기와 기능·제약 소개에서 지원 범위를 볼 수 있습니다.