# 入門

連接一個 App，選擇資料夾，按「立即同步」。

Exporter 讀取你 Mac 上的 App，把找到的內容寫成檔案，存放在你選擇的資料夾中，並在你繼續使用這些 App 時讓檔案保持最新。每個 App 的設定方式都一樣：連接它、選擇它的匯出資料夾、按「立即同步」。

## 安裝

從 Mac App Store 取得 Exporter（[下載](https://exporter.dev/download)），它在那裡的名稱是「Exporter: Notes to Markdown」。它需要 macOS 15 或以上版本，並在 Apple 晶片上執行。不需要帳號，也不需要登入任何東西。

## 連接一個 App

「首頁」上每個 App 各有一張卡片；Bear 和 Logseq 只有在已安裝時才會有卡片。

1. 在卡片上按「連接」。第一次打開時，歡迎卡片上的「連接 Apple 備忘錄」也能為 Apple 備忘錄完成同樣的事。
2. 一個資料夾面板會打開，而且已經位於該 App 的資料夾內。不要選擇其中的任何項目，直接按「選擇此資料夾」。Logseq 和文件則會請你選擇自己的資料夾：你的圖譜，或存放文件的資料夾。

這就是全部的權限：不需要完整磁碟取用權限，也不會出現 macOS 提示。Exporter 以唯讀方式讀取這一個資料夾，並記住它。從歡迎卡片連接 Apple 備忘錄後，會打開 Apple 備忘錄卡片進行下一步。

## 選擇匯出資料夾

按「選擇輸出檔案夾」，選擇這個 App 的檔案要存放的位置。資料夾的層級決定檔案存放的位置：

| 你選擇的是 | 檔案存放在 |
| --- | --- |
| 你的個人專屬資料夾，或直接位於其中的資料夾，例如 `~/Documents` 或 `~/Dropbox` | 在其中建立的新子資料夾，例如 `~/Documents/notes-export` |
| 更深層的資料夾，例如 `~/Documents/notes` | 就是那個資料夾本身 |

卡片上的 `匯出到` 列會顯示實際的資料夾，按「更改…」可以選擇其他資料夾。請為每個 App 設定各自的資料夾，並把它們並排放置，例如 `~/Documents/notes` 和 `~/Documents/messages`：[MCP 伺服器](https://exporter.dev/docs/mcp)只會提供與 Apple 備忘錄匯出資料夾並排的匯出資料夾。

## 執行首次匯出

按「立即同步」。寫入期間你可以關閉視窗。完成後，`上次同步` 會顯示時間和已匯出的項目數量，該 App 的即時同步也隨之開啟：從此以後，App 中的變更會自動寫入對應的檔案。

每個匯出資料夾也會有一個 `.exporter/`，也就是「匯出日誌」（時鐘圖像）顯示的每次執行紀錄。資料夾中還會出現哪些內容，以及檔案內的每個欄位，則因 App 而異：每個 App 在說明文件中都有自己的頁面，例如 [Apple 備忘錄](https://exporter.dev/docs/notes)。

## 持續執行的項目

- 關閉視窗不會停止任何事：App 會持續同步，Dock 圖像也一直在，直到你結束它。結束 App 會停止即時同步和 MCP 伺服器
- 設定 >「登入時啟動」會在重新開機後啟動 Exporter，讓同步自動繼續
- 設定 >「選單列模式」會加入一個顯示各 App 狀態的選單列圖像，而且啟動時不再打開視窗
- 即時同步沒有開關。它從一個 App 第一次按「立即同步」時開始，在你按「中斷連接」時停止；中斷連接會讓 App 忘記該 App 的資料夾，已匯出的檔案則留在原處
- App 結束時，從[命令列](https://exporter.dev/docs/cli)執行 `exporter sync` 就能跟上進度

## 解鎖

每個 App 在額度內都能免費匯出（Bear 和 Logseq 不限數量），而它匯出過的內容都會持續免費同步。App 卡片上的解鎖按鈕是該 App 的一次性購買，不是訂閱，「回復購買」則能在另一台 Mac 上恢復它（[價格](https://exporter.dev/pricing)）。

## 完全重新同步會移除什麼

卡片上的「完全重新同步」會先詢問，然後只移除 Exporter 在匯出資料夾中寫出的檔案。接著它會重新匯出，並重新選出免費的項目。資料夾中的其他內容都會保留：你自己的筆記、Obsidian 儲存庫的 `.obsidian`、一個存放文件的資料夾。儘管如此，還是請讓每個匯出擁有自己專用的資料夾，讓它的檔案和你的檔案分開。

一般同步只會移除 Exporter 自己寫出、且已沒有任何項目產生的檔案。

## 備份

匯出資料夾是一個鏡像：你在 App 中刪除的項目，下一次同步時也會從資料夾中移除，所以它不是封存。若要保留帶日期、永遠不變的副本，[備份 Apple 備忘錄](https://exporter.dev/guides/notes/back-up-apple-notes)會說明如何用命令列設定每晚的快照。復原就是把檔案拷貝回去：Exporter 從不寫入你的 App。

## Related

- [Apple Notes](https://exporter.dev/docs/notes): Folders, fields, HTML and fixes
- [Guides](https://exporter.dev/guides): One job each, step by step
- [Help](https://exporter.dev/docs/help): Problems and questions, with fixes

---

human version: https://exporter.dev/zh-hant/docs/getting-started
every page: https://exporter.dev/llms.txt