Document Editor

ヘルプ

ヘルプ

エディタを使うための実用的な答えをまとめました。すべてブラウザのタブ内で動作し、ファイルがアップロードされることはありません。

開く・新規作成する

どのファイル形式を開けますか?

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 として再びダウンロードできます。入力可能なフォームへの記入もできます。

既存の PDF の本文を Word のように書き換えられますか?

自由に流し込めるテキストとしては書き換えられません——PDF は固定レイアウトの形式です。文言を変えたい場合は、元の DOCX / XLSX / PPTX を開いて新しい PDF を書き出してください。どちらの手順もお使いの端末上で行われます。

読み取り専用と埋め込み

ドキュメントを読み取り専用で開けますか?

はい。/editor?file= のリンクに &readonly=1 を付けるか、埋め込み API で document:set-readonly を送ってください。読み取り専用は、ドキュメントを再読み込みせずに実行中に切り替えられます。

自分の Web アプリの中にエディタを置けますか?

はい——エディタは iframe に埋め込んで postMessage で操作できるように設計されています。あなたのページが(自前の認証で)ファイルを取得し、iframe に送り込み、編集後の File を受け取って好きな場所へアップロードします。Embed API リファレンスライブデモをご覧ください。

ブラウザの AI エージェント(WebMCP)

ブラウザの AI アシスタントにエディタを操作させられますか?

ブラウザが対応していれば、できます。エディタは WebMCP のツール一式を登録するため、ブラウザ内の AI エージェントは画面をクリックする代わりに、それらを直接呼び出してドキュメントを開き、変換し、読み、書き出せます。処理は変わらずお使いの端末で行われます——エージェントはボタンと同じ端末内のコードを呼ぶだけで、何もアップロードされません。

ツールは open_document_urlopen_document_buffercreate_documentsave_documentget_document_textset_readonlyget_document_state です。

どのブラウザが対応していますか?

WebMCP は W3C Web Machine Learning Community Group の提案で、現在は Chrome でオリジントライアルとして利用できます。Firefox と Safari は対応を表明していません。API を提供しないブラウザでは何も登録されず、動作も変わりません——純粋な追加機能です。

埋め込まれたエディタでも動きますか?

設計上、動きません。ツールはエディタがトップレベルのページであるときにのみ登録されます。クロスオリジンの iframe では埋め込み側ページが allow="tools" を付与する必要があり、それは埋め込みの本来の使い方と衝突します——エディタを埋め込む場合は、代わりに Embed API で操作してください。

エージェントはドキュメントの本文を読めますか?

ワープロ文書であれば読めます。get_document_text が本文を返すため、エージェントは何も書き出さずに内容についての質問に答えられます。表計算とプレゼンテーションはこのエンジンでは全文を公開していません。ツールは(空のファイルに見えてしまう空の答えを返す代わりに)その旨を明示し、書き出しを使うよう案内します。

オフラインとインストール

オフラインで動きますか?

はい。初回の訪問のあと、エディタは Service Worker によってキャッシュされます。ブラウザのアドレスバーからアプリ(PWA)としてインストールでき、接続がなくてもドキュメントを開けます。多くのフォントを使うドキュメントを最初に開くときだけは、そのフォントを取得するためにネットワークが一度必要です。その後はフォントもキャッシュされます。

最新版を入手するには?

サイトは次回の訪問時に自動で更新されます。古いビルドのままのように見える場合は、強制再読み込み(Ctrl+Shift+R / ⌘⇧R)するか、ブラウザのサイト設定で Service Worker の登録を解除してください。

プライバシー

ドキュメントはどこかにアップロードされますか?

いいえ。ドキュメントはディスクからブラウザのタブへ読み込まれ、そこで WebAssembly によって処理されます。このサイトにアップロード用のエンドポイントは存在しません。ドキュメントを開いて保存する際にブラウザのネットワークパネルで確認できますし、ソースは AGPL-3.0 で公開されています。

このページはネットワークから何を読み込みますか?

アプリケーション自体だけです。エディタの JavaScript、WebAssembly のコンバータ、フォント、ページ自身のアセット——すべてこのサイトのオリジンから——に加えて、プライバシーに配慮した Cloudflare Web Analytics のビーコン(Cookie なし、サイトをまたぐトラッキングなし)です。任意の AI アシスタントを自分の API キーで有効にした場合、その要求はあなたのブラウザから選んだプロバイダへ直接送られ、このサイトを経由することはありません。

エラー

通知に出るエラーコードの意味は?

  • -85 — ファイルの中身が拡張子と一致していません(例: HTML ページが .xls として保存されている、実体が .doc.docx など)。名前を変えるか、書き出し直してください。
  • -82 — ファイルを変換できませんでした。壊れている、パスワードで保護されている、あるいはエンジンが対応していない種類の可能性があります。
  • -24 / -25 — エディタのスクリプトの読み込みに失敗しました。多くはネットワークの一時的な問題か、古いキャッシュのビルドです。強制再読み込みしてからもう一度お試しください。
  • 80 — コンバータ内部で書き出しに失敗しました。別の出力形式をお試しください。それでも続く場合は、ファイルの種類と手順を添えて issue を立ててください。

何かおかしいときはどこに報告すればよいですか?

ブラウザとそのバージョン、ファイルの種類、そして——機密でなければ——問題が再現するファイルを添えて、GitHub に issue を立ててください。説明より、最小の再現手順のほうが役に立ちます。

セルフホスト

自分で運用できますか?

はい。静的サイトなので、どの Web サーバーでも動きます: docker run -d -p 8080:80 ghcr.io/ranuts/document:latest、あるいは pnpm run build でビルドして dist/ フォルダーを配信してください。HTTPS や Basic 認証の選択肢は README を、各リリースの変更点は変更履歴をご覧ください。

ソース: リポジトリの content/ja/help.md · GitHub