Ajuda

Abrir e criar documentos

Quais formatos de arquivo posso abrir?

Word (.docx, o antigo .doc), Excel (.xlsx, o antigo .xls), PowerPoint (.pptx, o antigo .ppt), valores separados por vírgula (.csv) e PDF (.pdf). Escolha um arquivo com Abrir, arraste-o para a página ou passe uma URL com /editor?file=https://… / /editor?src=https://… (o servidor que hospeda o arquivo precisa permitir requisições de outra origem).

Como crio um documento novo?

Escolha um novo arquivo do Word, Excel ou PowerPoint na página inicial. Edite o arquivo em branco e salve-o no seu dispositivo.

Existe limite de tamanho?

Não há limite fixo. O teto prático é a memória do seu dispositivo, porque o documento inteiro é analisado e renderizado localmente.

Editar e salvar

Como salvo minhas alterações?

Em navegadores compatíveis como Chrome e Edge, o primeiro salvamento permite escolher um arquivo; os seguintes o atualizam. Outros navegadores baixam uma cópia. Para outro formato, use Arquivo → Baixar como. As cópias de recuperação não substituem salvar o arquivo.

Por que o botão Salvar às vezes fica cinza?

Ele acende quando o editor carregou o documento por completo e você fez alguma alteração. Se continuar cinza depois de editar, o documento não terminou de carregar — veja se a notificação traz um erro e consulte a seção de códigos de erro abaixo.

Dá para converter entre formatos?

Sim, no seu dispositivo: abra um documento e escolha o formato de destino em Baixar como. Documentos do Word exportam para DOCX / PDF / TXT, planilhas para XLSX / CSV / PDF e apresentações para PPTX / PDF. Arquivos CSV são abertos como planilha e podem ser salvos de volta como CSV.

Meu CSV com acentos ou caracteres chineses aparece quebrado em outras ferramentas. E aqui?

O editor detecta a codificação do CSV antes de abrir — primeiro UTF-8 estrito, depois GB18030 (a codificação «ANSI» que o Excel usa nas exportações em chinês) e por fim Latin-1 — então arquivos que aparecem quebrados em outras ferramentas abrem certos aqui. Ao salvar, é gravado UTF-8 com marca de ordem de bytes, que o Excel abre sem assistente.

PDF

O que dá para fazer com um PDF?

Abrir e ler (rolar, ampliar, pesquisar), adicionar comentários e anotações de texto livre, e baixar de novo como um PDF que mantém essas anotações. Formulários preenchíveis podem ser preenchidos.

Dá para reescrever o texto de um PDF existente como num documento do Word?

Não como texto que flui livremente — o PDF é um formato de layout fixo. Para mudar a redação, abra o DOCX / XLSX / PPTX original e exporte um novo PDF. As duas etapas acontecem no seu dispositivo.

Somente leitura e incorporação

Dá para abrir um documento somente leitura?

Sim. Acrescente &readonly=1 a um link /editor?file=, ou envie document:set-readonly pela API de incorporação. O modo somente leitura pode ser ligado e desligado em tempo de execução, sem recarregar o documento.

Dá para colocar o editor dentro do meu próprio app web?

Sim — o editor foi feito para ser incorporado num iframe e controlado por postMessage: sua página busca o arquivo (com a própria autenticação), envia para o iframe e recebe de volta o File editado para enviar aonde quiser. Veja a referência da Embed API e a demo ao vivo.

Agentes de IA do navegador (WebMCP)

Um assistente de IA do meu navegador pode operar o editor?

As ferramentas WebMCP editam e convertem localmente, mas um agente do navegador pode receber texto ou arquivos exportados e enviá-los ao seu próprio serviço de IA. Confira a política de dados do agente antes de compartilhar conteúdo confidencial.

Quais navegadores dão suporte?

O WebMCP é uma proposta do W3C Web Machine Learning Community Group, disponível hoje no Chrome atrás de um origin trial. Firefox e Safari não anunciaram suporte. Onde o navegador não oferece a API, nada é registrado e nada muda — é uma adição pura.

Funciona num editor incorporado?

Não, por design. As ferramentas só são registradas quando o editor é a página de nível superior. Um iframe de outra origem exigiria que a página incorporadora concedesse allow="tools", o que conflita com o sentido da incorporação — se você incorporar o editor, controle-o pela Embed API.

O agente pode ler o texto do documento?

Em documentos de texto, sim: get_document_text devolve o texto para o agente responder perguntas sobre o conteúdo sem exportar nada. Planilhas e apresentações não expõem leitura de texto completo neste motor; a ferramenta diz isso explicitamente (em vez de devolver uma resposta vazia que pareceria um arquivo vazio) e aponta para a exportação.

Offline e instalação

Funciona offline?

Conecte-se primeiro, abra os arquivos necessários e teste a edição e a exportação. Depois desconecte-se e verifique os mesmos passos. Visitar a página inicial ou instalar o app não garante todas as funções offline. Limpar os dados do navegador pode exigir uma nova conexão. Abrir arquivos por links precisa de conexão.

Como recebo a versão mais nova?

O site se atualiza sozinho na próxima visita. Se uma página parecer presa numa versão antiga, recarregue forçado (Ctrl+Shift+R / ⌘⇧R) ou remova o registro do service worker nas configurações do site no navegador.

Privacidade

Meus documentos são enviados para algum lugar?

Ao editar arquivos locais diretamente neste site, os documentos são processados no seu dispositivo e não são enviados aos nossos servidores. O código é público para consulta. Se usar o editor em outro site ou permitir que um assistente externo leia arquivos, consulte a política de dados dele.

O que a página carrega da rede?

A página carrega código, recursos do editor, fontes e uma requisição do Cloudflare Web Analytics. URLs remotas podem gerar requisições adicionais. Apps anfitriões e agentes externos do navegador definem suas próprias políticas de dados.

Erros

O que significam os códigos de erro da notificação?

• -85 — o conteúdo do arquivo não corresponde à extensão (por exemplo, uma página HTML salva como .xls, ou um .docx que na verdade é um .doc). Renomeie ou exporte de novo.
• -82 — o arquivo não pôde ser convertido; pode estar corrompido, protegido por senha ou numa variante que o motor não suporta.
• -24 / -25 — um script do editor falhou ao carregar, normalmente um soluço de rede ou uma versão antiga em cache. Recarregue forçado e tente de novo.
• 80 — a exportação falhou dentro do conversor. Tente outro formato de destino; se persistir, abra uma issue com o tipo de arquivo e os passos.

Algo parece quebrado. Onde eu reporto?

Abra uma issue no GitHub com o navegador e a versão, o tipo de arquivo e — se não for confidencial — um arquivo que reproduza o problema. Uma reprodução mínima vale mais que uma descrição.

Auto-hospedagem

Posso rodar a minha própria cópia?

Sim. É um site estático, então qualquer servidor web serve: docker run -d -p 8080:80 ghcr.io/ranuts/document:latest, ou compile com pnpm run build e sirva a pasta dist/. Veja o README para opções de HTTPS e autenticação básica, e as novidades para o que mudou em cada versão.

O que fica depois de fechar a aba?

Com o salvamento automático ativado, as cópias de recuperação ficam neste navegador por 7 dias após a última edição ou abertura. Você pode excluí-las ou desativar o salvamento automático em /history. Os dados do navegador e as alterações ainda não salvas podem ser perdidos; salve as alterações importantes em um arquivo.

O assistente de IA integrado está disponível?

O assistente de IA integrado ainda não está concluído e não é uma função publicada.