Apple Notes

Kết nối

Nhấn “kết nối” trên thẻ Apple Notes (ở lần mở đầu tiên, nhấn “kết nối apple notes” trên thẻ chào mừng). Bảng chọn mở ra ở ~/Library/Group Containers/group.com.apple.notes: nhấn “Chọn thư mục này” mà không mở gì cả. Exporter đọc cơ sở dữ liệu Notes ở đó, chỉ đọc. Rồi nhấn “chọn thư mục xuất”, và “đồng bộ ngay”.

Tệp được lưu ở đâu

Một thư mục nằm ngay trong thư mục người dùng, như ~/Documents, sẽ có một thư mục notes-export bên trong; một thư mục sâu hơn, như ~/Documents/notes, được dùng nguyên như vậy. Hàng xuất tới hiển thị thư mục thật.

Tab mà thẻ đang mở cũng là cách sắp xếp thư mục:

tab	tệp được lưu vào
Thư mục	chính cây thư mục của Apple Notes
Thẻ	một thư mục đặt tên theo thẻ được đánh dấu đầu tiên của ghi chú; ghi chú không có thẻ nào được đánh dấu sẽ bị bỏ ra
Smart	một thư mục đặt tên theo thư mục thông minh của nó

Chuyển giữa các tab này sẽ di chuyển mọi tệp ở lần đồng bộ tiếp theo, và thẻ cho biết điều đó dưới các tab. Chia sẻ, Đã ghim, Gần đây và Hay xem là các danh sách: đánh dấu ở đó được tính như đánh dấu ở Thư mục.

Tệp được đặt tên theo tiêu đề ghi chú, bỏ dấu . và đổi / và : thành _. Hai ghi chú cùng tiêu đề trong một thư mục đều có thêm sáu ký tự của id, như Meeting-3f9a1c.md. Bên cạnh các ghi chú:

• attachments/, cạnh các ghi chú của từng thư mục
• bases/: all-notes.base, photo-notes.base và all-attachments.base, các chế độ xem cho Bases của Obsidian, được ghi lại ở mỗi lần xuất
• .exporter/: last-export.json và last-export.md cho lần chạy gần nhất, history/ với 50 lần gần nhất, và files.json, danh sách các tệp Exporter đã ghi

Những gì được xuất

Mọi ghi chú trong các thư mục hoặc thẻ được đánh dấu trên thẻ. Lần tải đầu tiên đánh dấu mọi thứ, và thư mục hay thẻ xuất hiện sau đó cũng được đánh dấu giúp bạn; những gì bạn bỏ đánh dấu sẽ vẫn không được đánh dấu.

Bị bỏ ra:

• ghi chú bị khóa, những ghi chú có mật khẩu
• ghi chú mà Apple Notes chưa tải từ iCloud về máy Mac này
• Đã xóa gần đây
• ghi chú của một thư mục thông minh được ghi “nên không xuất gì cả”: điều kiện tìm kiếm của nó không đọc được, nên hãy đánh dấu các ghi chú đó ở Thư mục

Trong tệp, danh sách kiểm tra trở thành - [ ] và - [x], bảng thành bảng Markdown, phần tô sáng thành ==text== và liên kết tới ghi chú khác thành [[wikilinks]]. Các #thẻ vẫn nằm trong văn bản. Gạch chân và màu chữ bị bỏ.

Tệp đính kèm

Hình ảnh, PDF, bản quét và bản vẽ được sao chép vào attachments/ và được nhúng đúng chỗ cũ, bằng ![[attachments/...]]. Một bản vẽ trở thành ảnh của nó, kèm chữ viết tay mà Apple nhận dạng được trích bên dưới. Tệp đính kèm không có trên máy Mac này sẽ bị bỏ qua, và Nhật ký xuất liệt kê nó là “source file not found”.

Markdown và HTML

Mặc định là Markdown. “chuyển sang html” trên hàng định dạng sẽ ghi mỗi ghi chú thành một trang web: kiểu trình bày nằm bên trong, nên không tải gì từ internet; id và ngày tháng của ghi chú ở đầu trang thay cho front matter; liên kết giữa các ghi chú thành liên kết giữa các trang; tệp đính kèm được sao chép vào attachments/ cạnh trang và được liên kết, nên hãy di chuyển trang cùng với thư mục đó.

Mỗi lần một định dạng. Một lần đồng bộ chỉ xóa các tệp cũ của định dạng mà nó ghi, nên khi chuyển đổi, các tệp của định dạng kia vẫn còn lại: hãy cho mỗi định dạng một thư mục riêng. Máy chủ MCP chỉ đọc Markdown.

Tệp

Các khóa front matter, luôn theo thứ tự này, mỗi khóa bị bỏ ra khi không áp dụng:

khóa	chứa
title	tiêu đề ghi chú
id	id của ghi chú trong Apple Notes
created, modified	thời gian gốc của Apple Notes, không có múi giờ, dạng mà Obsidian đọc là ngày tháng
source_url	một liên kết notes:// mở lại ghi chú trong Apple Notes
pinned, shared	true khi ghi chú được ghim hoặc chia sẻ
collaborators	những người mà ghi chú chia sẻ được chia sẻ với
cover	ảnh đầu tiên, dưới dạng wikilink tới bản sao của nó trong attachments/
links	các liên kết web trong ghi chú

Không có khóa tags. Một ghi chú trong Travel > Norway, dưới dạng 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]]

Miễn phí và mở khóa

100 ghi chú đầu tiên của bạn được xuất và tiếp tục đồng bộ miễn phí; ghi chú mới sau đó cần mở khóa một lần (bảng giá).

Đồng bộ và đồng bộ lại toàn bộ

Sau lần “đồng bộ ngay” đầu tiên, mọi chỉnh sửa trong Apple Notes được ghi vào tệp của nó trong lúc Exporter chạy, dù cửa sổ mở hay đóng. Thoát ứng dụng sẽ dừng việc này; exporter sync sẽ theo kịp phần còn thiếu. Khi bạn xóa, đổi tên hoặc di chuyển một ghi chú, lần đồng bộ tiếp theo sẽ xóa tệp cũ của nó, và chỉ những tệp có trong .exporter/files.json.

“đồng bộ lại toàn bộ” hỏi trước, rồi chỉ xóa các tệp Exporter đã ghi, xuất lại và chọn lại 100 ghi chú miễn phí. Mọi thứ khác trong thư mục xuất vẫn được giữ: ghi chú của riêng bạn, và .obsidian của một vault.

Sự cố và cách sửa

• “đó không phải thư mục Apple Notes”: bạn đã chọn thư mục khác. Nhấn “thử lại”, rồi “Chọn thư mục này” mà không mở gì cả
• thiếu một ghi chú bị khóa: bỏ khóa trong Apple Notes. Cài đặt > “chẩn đoán cơ sở dữ liệu ghi chú” đếm số ghi chú bị khóa
• thiếu ghi chú iCloud: mở Apple Notes và để nó đồng bộ xong, rồi kiểm tra số đã chọn trên thẻ
• tệp bị chuyển sang thư mục khác: thẻ đã chuyển sang tab khác. Quay lại tab bạn muốn và nhấn “đồng bộ ngay”
• một ghi chú thất bại: lần đồng bộ cuối hiển thị một liên kết “chi tiết” màu đỏ. “apple notes đang ghi ghi chú này và nó sẽ được xuất trong lần đồng bộ tiếp theo” sẽ tự hết; nếu “không thể đọc ghi chú từ cơ sở dữ liệu” cứ thất bại mãi, hãy gửi báo cáo từ Cài đặt > “chẩn đoán cơ sở dữ liệu ghi chú” kèm tiêu đề của ghi chú
• thiếu một ảnh: mở ghi chú trong Apple Notes để tệp của nó được tải về, rồi đồng bộ lại
• chỉnh sửa không hiện ra: Exporter phải đang chạy, và ghi chú phải được đánh dấu và nằm trong phần miễn phí