열기와 새로 만들기
어떤 파일 형식을 열 수 있나요?
Word(.docx, 예전 .doc), Excel(.xlsx, 예전 .xls), PowerPoint(.pptx, 예전 .ppt), 쉼표로 구분된 값(.csv), PDF(.pdf)입니다. 열기로 파일을 고르거나 페이지로 끌어다 놓거나, /editor?file=https://… / /editor?src=https://… 로 URL을 전달하세요(파일을 제공하는 서버가 교차 출처 요청을 허용해야 합니다).
새 문서를 만들려면?
홈페이지의 새 Word / 새 Excel / 새 PowerPoint를 쓰거나 /editor?new=docx, /editor?new=xlsx, /editor?new=pptx를 직접 여세요. 서버에는 아무것도 만들어지지 않습니다. 빈 문서는 내려받기 전까지 내 탭 안에만 존재합니다.
파일 크기 제한이 있나요?
정해진 제한은 없습니다. 문서 전체를 로컬에서 해석하고 렌더링하므로 실질적인 한계는 기기의 메모리입니다.
편집과 저장
변경 사항을 저장하려면?
Ctrl+S / ⌘S를 누르거나 파일 → 다른 이름으로 내려받기를 사용하세요. 서버가 없으므로 「저장」은 브라우저가 파일을 건네주는 것을 뜻합니다. 원래 이름으로 다운로드 폴더에 저장됩니다. 다른 이름으로 내려받기에서 다른 형식을 고르면 변환됩니다(예: DOCX → PDF, XLSX → CSV).
저장 버튼이 회색일 때가 있는데 왜인가요?
저장 버튼은 편집기가 문서를 완전히 읽어들이고 변경이 있을 때 활성화됩니다. 편집했는데도 계속 회색이라면 문서를 다 읽어들이지 못한 것입니다 — 알림 토스트에 오류가 있는지 확인하고 아래 오류 코드 절을 참고하세요.
형식을 서로 변환할 수 있나요?
네, 기기에서 가능합니다. 문서를 열고 다른 이름으로 내려받기에서 원하는 형식을 고르세요. 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 에이전트는 화면을 클릭하는 대신 그것들을 직접 호출해 문서를 열고 변환하고 읽고 내보낼 수 있습니다. 모든 처리는 여전히 기기에서 이루어집니다 — 에이전트는 버튼과 같은 기기 내 코드를 실행하며 아무것도 업로드되지 않습니다.
도구는 open_document_url, open_document_buffer, create_document, save_document, get_document_text, set_readonly, get_document_state입니다.
어떤 브라우저가 지원하나요?
WebMCP는 W3C Web Machine Learning Community Group의 제안이며 현재 Chrome에서 오리진 트라이얼로 제공됩니다. Firefox와 Safari는 지원을 밝히지 않았습니다. 브라우저가 API를 제공하지 않으면 아무것도 등록되지 않고 동작도 달라지지 않습니다 — 순수한 추가 기능입니다.
임베드된 편집기에서도 동작하나요?
설계상 동작하지 않습니다. 도구는 편집기가 최상위 페이지일 때만 등록됩니다. 교차 출처 iframe에서는 임베드하는 페이지가 allow="tools"를 부여해야 하는데 이는 임베드의 취지와 충돌합니다 — 편집기를 임베드한다면 Embed API로 다루세요.
에이전트가 문서의 본문을 읽을 수 있나요?
워드 문서라면 가능합니다. get_document_text가 본문을 돌려주므로 아무것도 내보내지 않고 내용에 대한 질문에 답할 수 있습니다. 스프레드시트와 프레젠테이션은 이 엔진에서 전문을 공개하지 않습니다. 도구는 (빈 파일처럼 보일 수 있는 빈 응답 대신) 그 사실을 분명히 알리고 내보내기를 안내합니다.
오프라인과 설치
오프라인에서 동작하나요?
네. 처음 방문한 뒤 편집기는 서비스 워커에 캐시됩니다. 브라우저 주소 표시줄에서 앱(PWA)으로 설치해 연결 없이 문서를 열 수 있습니다. 글꼴을 많이 쓰는 문서를 처음 열 때만 그 글꼴을 가져오기 위해 네트워크가 한 번 필요하며, 이후에는 글꼴도 캐시됩니다.
최신 버전을 받으려면?
사이트는 다음 방문 때 스스로 갱신됩니다. 페이지가 예전 빌드에 멈춘 것 같으면 강제 새로고침(Ctrl+Shift+R / ⌘⇧R)하거나 브라우저의 사이트 설정에서 서비스 워커 등록을 해제하세요.
프라이버시
문서가 어딘가로 업로드되나요?
아니요. 문서는 디스크에서 브라우저 탭으로 읽혀 그곳에서 WebAssembly로 처리됩니다. 이 사이트에는 업로드 엔드포인트가 없습니다. 문서를 열고 저장하는 동안 브라우저의 네트워크 패널에서 확인할 수 있고, 소스는 AGPL-3.0으로 공개되어 있습니다.
이 페이지는 네트워크에서 무엇을 읽어들이나요?
애플리케이션 자체뿐입니다. 편집기의 JavaScript, WebAssembly 변환기, 글꼴, 페이지 자체의 자원 — 모두 이 사이트의 오리진에서 — 그리고 프라이버시를 존중하는 Cloudflare Web Analytics 비콘(쿠키 없음, 사이트 간 추적 없음)입니다. 선택 사항인 AI 어시스턴트를 자신의 API 키로 켜면 그 요청은 브라우저에서 선택한 제공자로 직접 전송되며 이 사이트를 거치지 않습니다.
오류
알림에 나오는 오류 코드는 무슨 뜻인가요?
- -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를, 각 릴리스의 변경 사항은 변경 내역을 참고하세요.