# 文件

文件匯出的運作方式，從連接到排解問題。

## 連接

在文件卡片上按「連接」，然後選擇存放文件的資料夾；其中的所有內容（包括子資料夾）都會讀取。面板會在 `~/Documents` 中打開，也可以建立新資料夾。然後按「選擇輸出檔案夾」，選擇另一個資料夾，例如 `~/Documents/converted`。

匯出資料夾不能是文件資料夾本身或其中的資料夾，文件資料夾也不能位於匯出資料夾中：App 不會讓你選擇這兩種資料夾。

## 檔案存放的位置

每個輸出檔案都放在它的文件在資料夾中的相同位置，資料夾結構也相同：`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」或兩者；至少會保留一個勾選。文件是唯一能在一次同步中同時寫出兩種格式的 App。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 在匯出資料夾中寫出的檔案，再重新轉換你的文件。

## 問題與解決方法

- 列上的紅色三角形會說明文件失敗的原因，例如「此文件受密碼保護」或「此文件已損毀，缺少部分內容」。在製作它的 App 中修正，然後按列尾的轉換按鈕
- 列上有鎖頭，顯示「已達免費上限 · 解鎖文件後可轉換這一個」：這份文件超過了免費的十個
- 「無法開啟該資料夾」：文件資料夾已被搬移，或它所在的磁碟未裝載。再按一次「連接」
- 缺少某個 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-hant/docs/documents
every page: https://exporter.dev/llms.txt