# Apple 備忘錄

Apple 備忘錄匯出的運作方式，從連接到排解問題。

## 連接

在 Apple 備忘錄卡片上按「連接」（第一次打開時，則是歡迎卡片上的「連接 Apple 備忘錄」）。面板會在 `~/Library/Group Containers/group.com.apple.notes` 中打開：不要打開任何項目，直接按「選擇此資料夾」。Exporter 會以唯讀方式讀取那裡的備忘錄資料庫。然後按「選擇輸出檔案夾」，再按「立即同步」。

## 檔案存放的位置

直接位於個人專屬資料夾中的資料夾（例如 `~/Documents`）會在其中建立 `notes-export` 資料夾；更深層的資料夾（例如 `~/Documents/notes`）則直接使用。`匯出到` 列會顯示實際的資料夾。

卡片所在的標籤頁也決定了資料夾配置：

| 標籤頁 | 檔案存放在 |
| --- | --- |
| 「資料夾」 | Apple 備忘錄本身的資料夾樹狀結構 |
| 「標籤」 | 以備忘錄第一個勾選的標籤命名的資料夾；沒有勾選任何標籤的備忘錄不會匯出 |
| 「智慧」 | 以它所屬的智慧型資料夾命名的資料夾 |

在這些標籤頁之間切換，會在下一次同步時搬移每個檔案，卡片也會在標籤頁下方提示。「共享」、「已釘選」、「最近」和「常看」是清單：在那裡勾選，就等於在「資料夾」上勾選。

檔案以備忘錄的標題命名，其中的 `.` 會移除，`/` 和 `:` 會變成 `_`。同一個資料夾中有兩則同名的備忘錄時，兩者都會加上六個字元的 ID，例如 `Meeting-3f9a1c.md`。備忘錄旁邊還有：

- `attachments/`，放在每個資料夾的備忘錄旁邊
- `bases/`：`all-notes.base`、`photo-notes.base` 和 `all-attachments.base`，是給 Obsidian Bases 使用的檢視，每次匯出都會重新寫出
- `.exporter/`：最近一次執行的 `last-export.json` 和 `last-export.md`、存放最近 50 次執行的 `history/`，以及 `files.json`，也就是 Exporter 寫出的檔案清單

## 匯出的內容

卡片上勾選的資料夾或標籤中的每則備忘錄。第一次載入時會全部勾選，之後出現的資料夾和標籤也會自動幫你勾選；你取消勾選的項目則維持不勾選。

不匯出的內容：

- 已鎖定的備忘錄，也就是設有密碼的備忘錄
- Apple 備忘錄尚未從 iCloud 下載到這台 Mac 的備忘錄
- 「最近刪除」
- 標示為「因此不會輸出任何內容」的智慧型資料夾中的備忘錄：它的搜尋條件無法讀取，所以請在「資料夾」上勾選它的備忘錄

在檔案中，核對清單會變成 `- [ ]` 和 `- [x]`，表格變成 Markdown 表格，醒目標示變成 `==text==`，指向其他備忘錄的連結變成 `[[wikilinks]]`。你的 #標籤 會留在內文裡。底線和文字顏色會捨棄。

## 附件

影像、PDF、掃描檔和繪圖會拷貝到 `attachments/`，並以 `![[attachments/...]]` 嵌入在它們原本的位置。繪圖會變成它的影像，Apple 辨識出的手寫文字會以引文的形式放在影像下方。檔案不在這台 Mac 上的附件會略過，「匯出日誌」會將它列為「source file not found」。

## Markdown 和 HTML

預設是 Markdown。在 `格式` 列上按「切換為 HTML」，則會為每則備忘錄改寫出一個網頁：樣式內嵌在網頁中，所以不會從網路載入任何東西；備忘錄的 ID 和日期放在最上方，取代 front matter；備忘錄之間的連結變成網頁之間的連結；附件拷貝到網頁旁的 `attachments/` 並加上連結，所以搬移網頁時請連同那個資料夾一起搬。

一次一種格式。同步只會移除它所寫格式的舊檔案，所以切換後，另一種格式的檔案會留下來：請為每種格式設定各自的資料夾。MCP 伺服器只讀取 Markdown。

## 檔案

front matter 的鍵一律依以下順序排列，不適用時則省略：

| 鍵 | 內容 |
| --- | --- |
| `title` | 備忘錄的標題 |
| `id` | Apple 備忘錄為這則備忘錄指定的 ID |
| `created`、`modified` | Apple 備忘錄本身的時間，不含時區，是 Obsidian 會當作日期讀取的格式 |
| `source_url` | 一個可在 Apple 備忘錄中重新打開該則備忘錄的 `notes://` 連結 |
| `pinned`、`shared` | 備忘錄已釘選或已共享時為 `true` |
| `collaborators` | 共享備忘錄的共享對象 |
| `cover` | 第一張影像，以維基連結指向它在 `attachments/` 中的拷貝 |
| `links` | 備忘錄中的網頁連結 |

沒有 `tags` 鍵。一則位於「Travel > Norway」的備忘錄，寫成 `Travel/Norway/Bike tour, day 2.md`：

```markdown
---
title: "Bike tour, day 2"
id: "5B7E2C19"
created: 2025-06-21T20:14:02
modified: 2025-06-22T08:03:47
source_url: "notes://showNote?identifier=5B7E2C19"
links:
  - "https://www.visitnorway.com/"
---
# Bike tour, day 2

From Voss to Flåm. Ferry times are in [[Bike tour, day 1]].

![[attachments/Drawing 3f9a1c.png]]
```

## 免費與解鎖

前 100 則備忘錄可免費匯出並持續同步；之後的新備忘錄需要一次性解鎖（[價格](https://exporter.dev/pricing)）。

## 同步與完全重新同步

第一次按「立即同步」之後，只要 Exporter 在執行，無論視窗是否打開，你在 Apple 備忘錄中的每次編輯都會寫入對應的檔案。結束 App 會停止同步；`exporter sync` 可以跟上進度。你刪除、重新命名或搬移備忘錄時，下一次同步會移除它的舊檔案，而且只移除列在 `.exporter/files.json` 中的檔案。

「完全重新同步」會先詢問，然後只移除 Exporter 寫出的檔案，重新匯出，並重新選出免費的 100 則。匯出資料夾中的其他內容都會保留：你自己的筆記，以及儲存庫的 `.obsidian`。

## 問題與解決方法

- 「這不是 Apple 備忘錄的資料夾」：你選擇了其他資料夾。按「重試」，然後不要打開任何項目，直接按「選擇此資料夾」
- 少了一則已鎖定的備忘錄：在 Apple 備忘錄中移除鎖定。設定 >「備忘錄資料庫診斷」會計算已鎖定的備忘錄數量
- 少了 iCloud 備忘錄：打開 Apple 備忘錄並讓它完成同步，然後查看卡片上的 `已選` 數量
- 檔案被搬到其他資料夾：卡片切換到了其他標籤頁。回到你要的標籤頁，然後按「立即同步」
- 有備忘錄失敗：`上次同步` 會顯示紅色的「詳細資訊」連結。「Apple 備忘錄當時正在寫入這則備忘錄，會在下次同步時匯出」會自行解決；如果「無法從資料庫讀取備忘錄」一直失敗，請從設定 >「備忘錄資料庫診斷」傳送報告，並附上該則備忘錄的標題
- 少了一張影像：在 Apple 備忘錄中打開該則備忘錄讓它的檔案下載，然後再同步一次
- 編輯沒有出現：Exporter 必須在執行，而且該則備忘錄必須已勾選並在免費額度內

## Related

- [Export Apple Notes to Markdown](https://exporter.dev/notes): Apple Notes as Markdown, kept in sync
- [Apple Notes guides](https://exporter.dev/guides/notes): Obsidian, backups, Claude and Wander
- [Help](https://exporter.dev/docs/help): Problems and questions, with fixes

---

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