# 文档

文档导出如何工作，从连接到修复问题。

## 连接

在文档卡片上点按“连接”，然后选择你的文档所在的文件夹；其中的所有内容，包括子文件夹，都会被读取。面板会在 `~/Documents` 中打开，也可以新建文件夹。然后点按“选择导出文件夹”，选择一个单独的文件夹，如 `~/Documents/converted`。

导出文件夹不能是文档文件夹或其中的文件夹，文档文件夹也不能位于导出文件夹之内：应用不允许你选择这两种情况。

## 文件存放在哪里

每个输出文件的位置与其文档在你文件夹中的位置相同，保持同样的文件夹结构：`report.md`，勾选了 HTML 时旁边还有 `report.html`。同一文件夹中两个同名的文档，会在文件名中保留各自的扩展名：`report-pdf.md`、`report-docx.md`。直接位于个人文件夹中的文件夹，如 `~/Documents`，会在其中新建一个 `documents-export` 文件夹；更深层的文件夹会被直接使用。

## 能读取的内容

| 类型 | 文件 |
| --- | --- |
| Word 和文本 | `.doc`、`.docx`、`.docm`、`.odt`、`.rtf` |
| 演示文稿 | `.ppt`、`.pps`、`.pot`、`.pptx`、`.pptm`、`.ppsx`、`.ppsm`、`.odp` |
| 电子表格 | `.xls`、`.xlsx`、`.xlsm`、`.xlsb`、`.ods`、`.csv` |
| PDF 和图书 | `.pdf`、`.epub` |

不会读取：Pages、Numbers 和 Keynote 文件（请先把它们导出为 Word、PowerPoint、Excel 或 PDF）、隐藏文件、文件包中的文件，以及符号链接。标签页用于筛选列表：“全部”“PDF”“Word”“幻灯片”“表格”“图书”和“扫描件”。

## 扫描页

没有文本的 PDF 页面由 Apple 的文本识别在你的 Mac 上读取；不会上传任何内容。无法识别的页面会写成 `> 第 <n> 页：无法读取扫描页`。文本识别只用于 PDF。

## Markdown 和 HTML

在 `格式` 一行上勾选“Markdown”“HTML”或两者；至少要勾选一项。文档是唯一能在一次同步中同时写出两种格式的应用。HTML 是朴素的，没有样式。MCP 服务器只读取 Markdown。

## 文件

| 键 | 内容 |
| --- | --- |
| `title` | 不带扩展名的文件名 |
| `source` | 文档在你的文档文件夹中的路径 |
| `format` | 原始扩展名 |
| `pages` | PDF 的页数 |
| `scanned` | 页面由文本识别读取时为 `true` |
| `modified` | 文档的最后更改时间 |

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

# Quarterly report
```

## 免费与解锁

在你勾选的文档中，最近修改的 10 个可以免费转换，一个文档的两种格式只算一次；其余的需要一次性解锁（[价格](https://exporter.dev/pricing)）。

## 同步和完全重新同步

首次点按“立即同步”后，Exporter 会在运行期间监视这个文件夹，在你存储后几秒钟内转换有变化的内容。如果某个文档的 Markdown 已经比它新，就会直接跳过而不打开，所以大文件夹也能保持快速。行末的转换按钮会立即转换那一个文档，无论是否勾选。已删除文档的输出会在下次同步时移除。

“完全重新同步”会先询问，然后只删除 Exporter 在导出文件夹中写入的文件，再重新转换你的文档。

## 问题和修复

- 某一行上的红色三角形会说明该文档失败的原因，例如“此文档受密码保护”或“此文档已损坏，缺少部分内容”。在创建它的应用中修复，然后点按该行末尾的转换按钮
- 某一行上有一把锁，显示“已达免费上限 · 解锁文档后可转换这一个”：该文档超出了免费的 10 个
- “无法打开该文件夹”：文档文件夹已移动，或它所在的磁盘未装载。再次点按“连接”
- 缺少 Pages、Numbers 或 Keynote 文件：把它导出为 Word、PowerPoint、Excel 或 PDF，导出的结果就会被转换

## 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/zh-hans/docs/documents
every page: https://exporter.dev/llms.txt