# Documentos

Como a exportação de Documentos funciona, da conexão à solução de problemas.

## Conectar

Clique em “conectar” no cartão Documentos e escolha a pasta onde estão os seus documentos; tudo dentro dela, inclusive as subpastas, é lido. O painel abre em `~/Documents` e pode criar uma pasta nova. Depois clique em “escolher pasta de destino” e escolha uma pasta separada, como `~/Documents/converted`.

A pasta de exportação não pode ser a pasta de documentos nem uma pasta dentro dela, e a pasta de documentos não pode ficar dentro da pasta de exportação: o app não deixa você escolher nenhum dos dois casos.

## Onde ficam os arquivos

Cada arquivo gerado fica onde o seu documento fica na sua pasta, com a mesma estrutura de pastas: `report.md`, e `report.html` ao lado dele quando HTML está marcado. Dois documentos com o mesmo nome numa pasta mantêm a extensão no nome do arquivo: `report-pdf.md`, `report-docx.md`. Uma pasta logo dentro da sua pasta pessoal, como `~/Documents`, ganha uma pasta `documents-export` dentro dela; uma mais funda é usada como está.

## O que é lido

| tipo | arquivos |
| --- | --- |
| Word e texto | `.doc`, `.docx`, `.docm`, `.odt`, `.rtf` |
| Apresentações | `.ppt`, `.pps`, `.pot`, `.pptx`, `.pptm`, `.ppsx`, `.ppsm`, `.odp` |
| Planilhas | `.xls`, `.xlsx`, `.xlsm`, `.xlsb`, `.ods`, `.csv` |
| PDF e livros | `.pdf`, `.epub` |

Ficam de fora: arquivos do Pages, Numbers e Keynote (exporte-os antes para Word, PowerPoint, Excel ou PDF), arquivos ocultos, arquivos dentro de pacotes e links simbólicos. As abas filtram a lista: “Todos”, “PDF”, “Word”, “Slides”, “Folhas”, “Livros” e “Scans”.

## Páginas digitalizadas

Uma página de PDF sem texto é lida pelo reconhecimento de texto da Apple no seu Mac; nada é enviado. Uma página que ele não consegue ler vira `> página <n>: não foi possível ler a página escaneada`. O reconhecimento de texto roda só em PDFs.

## Markdown e HTML

Marque “Markdown”, “HTML” ou os dois na linha “formato”; pelo menos um fica marcado. Documentos é o único app que grava os dois numa mesma sincronização. O HTML é simples, sem estilo. O servidor MCP lê só o Markdown.

## O arquivo

| chave | contém |
| --- | --- |
| `title` | o nome do arquivo sem a extensão |
| `source` | o caminho do documento dentro da sua pasta de documentos |
| `format` | a extensão original |
| `pages` | o número de páginas de um PDF |
| `scanned` | `true` quando o reconhecimento de texto leu as páginas |
| `modified` | quando o documento mudou pela última vez |

```markdown
---
title: "Quarterly report"
source: "Work/Quarterly report.pdf"
format: pdf
pages: 12
scanned: true
modified: 2026-08-30T17:02:11Z
---

# Quarterly report
```

## Grátis e desbloqueado

Seus 10 documentos modificados mais recentemente entre os que você marcou são convertidos grátis, e os dois formatos de um documento contam uma vez só; o resto precisa do desbloqueio único ([preços](https://exporter.dev/pricing)).

## Sincronização e ressincronização completa

Depois do primeiro “sincronizar agora”, o Exporter observa a pasta enquanto está aberto e converte o que mudou alguns segundos depois de você salvar. Um documento cujo Markdown já é mais novo que ele é pulado sem ser aberto, então uma pasta grande continua rápida. O botão de conversão no fim de uma linha converte aquele documento agora, marcado ou não. O arquivo gerado de um documento apagado sai na próxima sincronização.

“ressincronização completa” pergunta antes e depois remove apenas os arquivos que o Exporter gravou na pasta de exportação e converte os seus documentos de novo.

## Problemas e soluções

- um triângulo vermelho numa linha dá o motivo pelo qual o documento falhou, como “este documento está protegido por senha” ou “este documento está danificado e falta parte do seu conteúdo”. Corrija no app que o criou e depois clique no botão de conversão no fim da linha
- um cadeado numa linha, “limite grátis atingido · desbloqueie documentos para converter este”: o documento passou dos dez grátis
- “não foi possível abrir essa pasta”: a pasta de documentos foi movida ou o disco dela não está montado. Clique em “conectar” de novo
- falta um arquivo do Pages, Numbers ou Keynote: exporte-o para Word, PowerPoint, Excel ou PDF, e o resultado é convertido

## Related

- [Documents](https://exporter.dev/documents): Word, slides, sheets and PDFs to Markdown
- [Documents guides](https://exporter.dev/guides/documents): Documents Claude can read
- [Help](https://exporter.dev/docs/help): Problems and questions, with fixes

---

human version: https://exporter.dev/pt-br/docs/documents
every page: https://exporter.dev/llms.txt