열기와 새로 만들기
어떤 파일 형식을 열 수 있나요?
Word(.docx, 예전 .doc), Excel(.xlsx, 예전 .xls), PowerPoint(.pptx, 예전 .ppt), 쉼표로 구분된 값(.csv), PDF(.pdf)입니다. 열기로 파일을 고르거나 페이지로 끌어다 놓거나, /editor?file=https://… / /editor?src=https://… 로 URL을 전달하세요(파일을 제공하는 서버가 교차 출처 요청을 허용해야 합니다).
새 문서를 만들려면?
기본 파일 열기, 편집, 형식 변환은 브라우저에서 로컬로 실행되며 문서 업로드가 필수는 아닙니다. 자동 저장을 켜면 복구 사본이 이 브라우저의 IndexedDB에 마지막 편집 또는 열기 후 7일 동안 보관됩니다. 탭을 닫아도 삭제되지 않습니다. /history에서 사본을 삭제하거나 자동 저장을 끌 수 있습니다. 브라우저 저장소가 지워지거나 회수될 수 있고 아직 저장되지 않은 편집은 유실될 수 있습니다. 복구 기능은 파일 저장을 대신하지 않습니다.
파일 크기 제한이 있나요?
정해진 제한은 없습니다. 문서 전체를 로컬에서 해석하고 렌더링하므로 실질적인 한계는 기기의 메모리입니다.
편집과 저장
변경 사항을 저장하려면?
File System Access API를 지원하는 Chrome, Edge 등의 브라우저에서는 첫 저장 때 파일을 선택하고 이후에는 같은 파일에 씁니다. 다른 브라우저는 사본을 다운로드합니다. 파일 → 다른 이름으로 다운로드에서 다른 형식으로 내보낼 수 있습니다. 브라우저 복구 사본은 저장한 파일과 별개입니다.
저장 버튼이 회색일 때가 있는데 왜인가요?
저장 버튼은 편집기가 문서를 완전히 읽어들이고 변경이 있을 때 활성화됩니다. 편집했는데도 계속 회색이라면 문서를 다 읽어들이지 못한 것입니다 — 알림 토스트에 오류가 있는지 확인하고 아래 오류 코드 절을 참고하세요.
형식을 서로 변환할 수 있나요?
네, 기기에서 가능합니다. 문서를 열고 다른 이름으로 내려받기에서 원하는 형식을 고르세요. Word 문서는 DOCX / PDF / TXT로, 스프레드시트는 XLSX / CSV / PDF로, 프레젠테이션은 PPTX / PDF로 내보낼 수 있습니다. CSV는 스프레드시트로 열리며 다시 CSV로 저장할 수 있습니다.
한글이나 중국어가 든 CSV가 다른 도구에서 깨집니다. 여기서는 어떤가요?
편집기는 열기 전에 CSV의 인코딩을 판별합니다 — 먼저 엄격한 UTF-8, 다음 GB18030(중국어판 Excel이 쓰는 「ANSI」 인코딩), 마지막으로 Latin-1 순서입니다. 그래서 다른 도구에서 깨져 보이는 파일도 제대로 열립니다. 저장할 때는 바이트 순서 표시가 붙은 UTF-8로 기록하므로 Excel에서 마법사 없이 열립니다.
PDF로 무엇을 할 수 있나요?
열어서 읽고(스크롤, 확대, 검색), 의견과 자유 텍스트 주석을 달고, 그 주석을 유지한 PDF로 다시 내려받을 수 있습니다. 입력 가능한 양식은 채울 수 있습니다.
기존 PDF의 본문을 Word처럼 다시 쓸 수 있나요?
자유롭게 흐르는 텍스트로는 다시 쓸 수 없습니다 — PDF는 레이아웃이 고정된 형식입니다. 문구를 바꾸려면 원본 DOCX / XLSX / PPTX를 열어 새 PDF를 내보내세요. 두 단계 모두 기기에서 이루어집니다.
읽기 전용과 임베드
문서를 읽기 전용으로 열 수 있나요?
네. /editor?file= 링크에 &readonly=1을 붙이거나 임베드 API로 document:set-readonly를 보내세요. 읽기 전용은 문서를 다시 불러오지 않고 실행 중에 켜고 끌 수 있습니다.
내 웹 앱 안에 편집기를 넣을 수 있나요?
네 — 편집기는 iframe에 임베드해 postMessage로 다루도록 설계되어 있습니다. 내 페이지가 (자체 인증으로) 파일을 가져와 iframe에 보내고, 편집된 File을 돌려받아 원하는 곳에 업로드하면 됩니다. Embed API 참고와 라이브 데모를 확인하세요.
브라우저 AI 에이전트(WebMCP)
브라우저의 AI 어시스턴트가 편집기를 다룰 수 있나요?
WebMCP 도구의 편집과 변환은 로컬에서 실행되지만, 브라우저 에이전트는 문서 텍스트나 내보낸 파일을 받아 자신의 AI 서비스에 보낼 수 있습니다. 기밀 내용을 공유하기 전에 에이전트의 데이터 정책을 확인하세요.
어떤 브라우저가 지원하나요?
WebMCP는 W3C Web Machine Learning Community Group의 제안이며 현재 Chrome에서 오리진 트라이얼로 제공됩니다. Firefox와 Safari는 지원을 밝히지 않았습니다. 브라우저가 API를 제공하지 않으면 아무것도 등록되지 않고 동작도 달라지지 않습니다 — 순수한 추가 기능입니다.
임베드된 편집기에서도 동작하나요?
설계상 동작하지 않습니다. 도구는 편집기가 최상위 페이지일 때만 등록됩니다. 교차 출처 iframe에서는 임베드하는 페이지가 allow="tools"를 부여해야 하는데 이는 임베드의 취지와 충돌합니다 — 편집기를 임베드한다면 Embed API로 다루세요.
에이전트가 문서의 본문을 읽을 수 있나요?
워드 문서라면 가능합니다. get_document_text가 본문을 돌려주므로 아무것도 내보내지 않고 내용에 대한 질문에 답할 수 있습니다. 스프레드시트와 프레젠테이션은 이 엔진에서 전문을 공개하지 않습니다. 도구는 (빈 파일처럼 보일 수 있는 빈 응답 대신) 그 사실을 분명히 알리고 내보내기를 안내합니다.
오프라인과 설치
오프라인에서 동작하나요?
오프라인 편집에는 앱, 편집 엔진, 변환기와 필요한 글꼴 및 형식 리소스가 브라우저에 캐시되고 유지되어야 합니다. 한 번 방문하거나 PWA를 설치하는 것만으로 보장되지는 않습니다. 원격 파일 URL에는 네트워크가 필요합니다.
최신 버전을 받으려면?
사이트는 다음 방문 때 스스로 갱신됩니다. 페이지가 예전 빌드에 멈춘 것 같으면 강제 새로고침(Ctrl+Shift+R / ⌘⇧R)하거나 브라우저의 사이트 설정에서 서비스 워커 등록을 해제하세요.
프라이버시
문서가 어딘가로 업로드되나요?
기본 파일 열기, 편집, 형식 변환은 브라우저에서 로컬로 실행되며 문서 업로드가 필수는 아닙니다. 내장 AI 어시스턴트는 아직 완성되지 않았으며 출시된 기능이 아닙니다. 임베드 호스트는 내보낸 파일을 받아 자체 정책에 따라 업로드할 수 있습니다.
이 페이지는 네트워크에서 무엇을 읽어들이나요?
페이지는 앱 코드, 편집기 리소스, 글꼴과 Cloudflare Web Analytics 요청을 불러옵니다. 원격 URL은 추가 요청을 만들 수 있습니다. 임베드 호스트와 외부 브라우저 에이전트는 자체 데이터 정책을 따릅니다.
오류
알림에 나오는 오류 코드는 무슨 뜻인가요?
- -85 — 파일 내용이 확장자와 맞지 않습니다(예: HTML 페이지가
.xls로 저장됨, 실제로는.doc인.docx). 이름을 바꾸거나 다시 내보내세요. - -82 — 파일을 변환할 수 없습니다. 손상되었거나 암호로 보호되었거나 엔진이 지원하지 않는 형태일 수 있습니다.
- -24 / -25 — 편집기 스크립트를 읽어들이지 못했습니다. 대개 일시적인 네트워크 문제이거나 오래된 캐시 빌드입니다. 강제 새로고침 후 다시 시도하세요.
- 80 — 변환기 내부에서 내보내기에 실패했습니다. 다른 출력 형식을 시도해 보시고, 계속된다면 파일 종류와 절차를 적어 이슈를 남겨 주세요.
뭔가 잘못된 것 같습니다. 어디에 알리면 되나요?
브라우저와 버전, 파일 종류, 그리고 — 기밀이 아니라면 — 문제를 재현하는 파일과 함께 GitHub에 이슈를 남겨 주세요. 설명보다 최소 재현이 훨씬 도움이 됩니다.
자체 호스팅
직접 운영할 수 있나요?
네. 정적 사이트이므로 어떤 웹 서버든 됩니다: docker run -d -p 8080:80 ghcr.io/ranuts/document:latest, 또는 pnpm run build로 빌드하고 dist/ 폴더를 제공하세요. HTTPS와 기본 인증 옵션은 README를, 각 릴리스의 변경 사항은 변경 내역을 참고하세요.
탭을 닫으면 무엇이 남나요?
자동 저장을 켜면 복구 사본이 이 브라우저의 IndexedDB에 마지막 편집 또는 열기 후 7일 동안 보관됩니다. 탭을 닫아도 삭제되지 않습니다. /history에서 사본을 삭제하거나 자동 저장을 끌 수 있습니다. 브라우저 저장소가 지워지거나 회수될 수 있고 아직 저장되지 않은 편집은 유실될 수 있습니다. 복구 기능은 파일 저장을 대신하지 않습니다.
내장 AI 어시스턴트를 사용할 수 있나요?
내장 AI 어시스턴트는 아직 완성되지 않았으며 출시된 기능이 아닙니다. 임베드 호스트는 내보낸 파일을 받아 자체 정책에 따라 업로드할 수 있습니다.