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：

---
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 則備忘錄可免費匯出並持續同步；之後的新備忘錄需要一次性解鎖（價格）。

同步與完全重新同步

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

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

問題與解決方法

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