Mail

Kết nối

Bấm «Kết nối» bên cạnh Mail trên trang chính của Exporter (Mail nằm ở hàng «Thêm N ứng dụng» cho đến khi bạn kết nối), rồi «Mở thư mục Mail». Bảng chọn mở ra ở ~/Library/Mail: chọn chính thư mục đó. Rồi chọn nơi lưu tệp và bấm «Dùng thư mục này».

Exporter đọc thư mà Mail lưu trên máy Mac qua thư mục bạn đã cho phép. Nó không hỏi quyền truy cập thư, không cần tài khoản và không cần Truy cập toàn bộ ổ đĩa.

Chọn email

Trang chọn có hai tab, và một email được đồng bộ khi cả hai tab đều chọn nó.

• Loại: các tab của chính Mail. Chính, Giao dịch, Cập nhật, Khuyến mãi, và Mail chưa phân loại cho phần còn lại. Cập nhật và Khuyến mãi lúc đầu không được chọn.
• Tài khoản: mỗi tài khoản theo địa chỉ, với các hộp thư của nó bên trong. Thư nháp và Thùng rác lúc đầu không được chọn.

Thư đã xóa, Spam và Thư rác không bao giờ được đồng bộ, dù bạn chọn gì. Con số phía trên danh sách là những gì hai tab cùng giữ lại.

Các tệp đi đâu

Mỗi email một tệp Markdown, đặt tên theo ngày, tiêu đề thư và một con số: 2026-09-28 Your order has shipped 491560.md. Một thư mục nằm ngay trong thư mục nhà của bạn, như ~/Documents, sẽ có thêm thư mục mail-export bên trong; một thư mục sâu hơn được dùng đúng như vậy.

«Sắp xếp», trong «Tùy chọn…» trên thẻ, quyết định các thư mục:

• Theo ngày: 2026/09/, mỗi năm và tháng một thư mục
• Theo tài khoản: mỗi tài khoản một thư mục, rồi đến năm
• Theo loại: primary/, transactions/, updates/, promotions/, unsorted/, rồi đến năm

Đổi Sắp xếp sẽ chuyển mọi tệp ở lần đồng bộ tiếp theo. Không có gì bị để lại ở chỗ cũ.

Tệp

Front matter chứa from, to, mailbox, read, flagged khi thư được gắn cờ, account và kind, cùng source_url mở email trong Mail. Rồi đến tiêu đề thư làm tiêu đề và nội dung dưới dạng Markdown: đề mục, danh sách, bảng và liên kết. Tệp đính kèm ở lại trong Mail. Một email mà Mail chưa từng tải nội dung về sẽ ghi rõ điều đó trong tệp của nó.

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

1.000 email mới nhất của bạn được xuất và tiếp tục đồng bộ miễn phí. «Mở khóa Mail» là một lần mua: sau đó, bấm «Đồng bộ ngay» và phần còn lại trong những gì đã chọn sẽ được đồng bộ. Nếu bạn thoát ứng dụng giữa lần đồng bộ đầu tiên của một hộp thư lớn, nó sẽ tiếp tục từ chỗ đã dừng.

Đồng bộ

Khi Exporter đang chạy, nó theo dõi chỉ mục của Mail, và thư mới tự trở thành tệp. «Đồng bộ ngay» chạy đồng bộ bằng tay; «Đồng bộ lại toàn bộ» ghi lại mọi tệp.

Dòng lệnh

exporter sync --source mail đồng bộ Mail giống «Đồng bộ ngay» trên thẻ. exporter export --source mail --dest <folder> ghi các email vào một thư mục đã cho phép trên thẻ «Dòng lệnh» và không đụng tới lần đồng bộ riêng của thẻ. Xem dòng lệnh.

Sự cố và cách xử lý

• Trang chọn không có thư nào: chọn chính ~/Library/Mail trong bảng chọn, không phải một thư mục bên trong. Ngắt kết nối rồi kết nối lại để bảng chọn hiện ra lần nữa.
• Thiếu một tài khoản: tài khoản không có email nào để ghi (chẳng hạn một Hộp thư đi trống) sẽ không được liệt kê.
• Một tệp ghi rằng nội dung chưa được tải về: Mail chỉ có phần đầu thư. Mở email trong Mail một lần và lần đồng bộ tiếp theo sẽ ghi nội dung.