احصل على Exporter
التوثيقملاحظات Apple

ملاحظات Apple

كيف يعمل تصدير ملاحظات Apple، من الربط حتى حل المشكلات.

الربط

اضغط «توصيل» في بطاقة ملاحظات Apple (وعند أول تشغيل، «توصيل ملاحظات Apple» في بطاقة الترحيب). تُفتح اللوحة في ~/Library/Group Containers/group.com.apple.notes: اضغط «اختيار هذا المجلد» دون فتح أي شيء. يقرأ Exporter قاعدة بيانات الملاحظات هناك، للقراءة فقط. ثم اضغط «اختر مجلد التصدير»، ثم «مزامنة الآن».

أين تذهب الملفات

المجلد الموجود مباشرة في مجلد الحساب الرئيسي، مثل ~/Documents، يحصل على مجلد notes-export داخله؛ أما المجلد الأعمق، مثل ~/Documents/notes، فيُستخدم كما هو. ويعرض صف «التصدير إلى» المجلد الفعلي.

وعلامة التبويب المفتوحة في البطاقة هي أيضًا ترتيب المجلدات:

علامة التبويب أين تُحفظ الملفات
«المجلدات» شجرة مجلدات ملاحظات Apple نفسها
«العلامات» مجلد يحمل اسم أول وسم محدَّد في الملاحظة؛ والملاحظة التي بلا وسم محدَّد تُستبعد
«ذكية» مجلد يحمل اسم مجلدها الذكي

التبديل بين علامات التبويب هذه ينقل كل الملفات في المزامنة التالية، وتقول البطاقة ذلك تحت علامات التبويب. أما «المشتركة» و«المثبّتة» و«الأخيرة» و«الشائعة» فقوائم: التحديد فيها يُحتسب تحديدًا في «المجلدات».

يحمل الملف عنوان الملاحظة، مع حذف . وتحويل / و: إلى _. والملاحظتان اللتان تحملان العنوان نفسه في مجلد واحد تحصل كل منهما على ستة أحرف من معرّفها، مثل Meeting-3f9a1c.md. وبجوار الملاحظات:

  • attachments/، بجوار ملاحظات كل مجلد
  • bases/: all-notes.base وphoto-notes.base وall-attachments.base، عروض لميزة Bases في Obsidian، تُعاد كتابتها مع كل تصدير
  • .exporter/: last-export.json وlast-export.md لآخر تشغيل، وhistory/ بآخر 50 تشغيلًا، وfiles.json، وهو قائمة الملفات التي كتبها Exporter

ما الذي يُصدَّر

كل ملاحظة في المجلدات أو الوسوم المحدَّدة في البطاقة. التحميل الأول يحدّد كل شيء، والمجلدات والوسوم التي تظهر لاحقًا تُحدَّد لك؛ وما تلغي تحديده يبقى غير محدَّد.

ما يُستبعد:

  • الملاحظات المقفلة، أي التي لها كلمة مرور
  • الملاحظات التي لم ينزّلها تطبيق ملاحظات Apple من iCloud إلى جهاز Mac هذا بعد
  • المحذوفة مؤخرًا
  • ملاحظات المجلد الذكي الذي تنتهي رسالته بـ«لذا لن يُصدَّر أي شيء»: بحثه لا يمكن قراءته، فحدّد ملاحظاته في «المجلدات»

في الملف، تصبح قوائم المهام - [ ] و- [x]، والجداول جداول Markdown، والنصوص المظلَّلة ==text==، والروابط إلى ملاحظات أخرى [[wikilinks]]. وتبقى وسومك التي تبدأ بعلامة # داخل النص. ويسقط التسطير وألوان النص.

المرفقات

تُنسخ الصور وملفات PDF والمستندات الممسوحة والرسومات إلى attachments/ وتُضمَّن حيث كانت، بالصيغة ![[attachments/...]]. ويصبح الرسم صورته، مع أي خط يد تعرّفت عليه Apple مقتبسًا تحته. والمرفق الذي لا يوجد ملفه على جهاز Mac هذا يُتخطّى، ويسرده «سجل التصدير» بعبارة “source file not found”.

Markdown وHTML

Markdown هو الافتراضي. و«التبديل إلى html» في صف «الصيغة» يكتب صفحة ويب لكل ملاحظة بدلًا من ذلك: أنماطها بداخلها، فلا يُحمَّل شيء من الإنترنت؛ ومعرّف الملاحظة وتواريخها في الأعلى بدلًا من الترويسة؛ والروابط بين الملاحظات روابط بين الصفحات؛ والمرفقات منسوخة إلى attachments/ بجوار الصفحة ومرتبطة بها، لذا انقل الصفحة مع ذلك المجلد معًا.

صيغة واحدة في كل مرة. لا تحذف المزامنة إلا الملفات القديمة من الصيغة التي تكتبها، لذا يترك التبديل ملفات الصيغة الأخرى في مكانها: خصّص لكل صيغة مجلدًا مستقلًا. ولا يقرأ خادم MCP إلا Markdown.

الملف

مفاتيح الترويسة، بهذا الترتيب دائمًا، ويُحذف كل منها حين لا ينطبق:

المفتاح ما يحويه
title عنوان الملاحظة
id معرّف ملاحظات Apple للملاحظة
created، modified أوقات ملاحظات Apple نفسها، دون منطقة زمنية، بالشكل الذي يقرؤه Obsidian كتواريخ
source_url رابط notes:// يعيد فتح الملاحظة في ملاحظات Apple
pinned، shared true حين تكون الملاحظة مثبّتة أو مشتركة
collaborators الأشخاص الذين تُشارَك معهم الملاحظة المشتركة
cover أول صورة، كرابط wikilink إلى نسختها في 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 ملاحظة تُصدَّر وتبقى متزامنة مجانًا؛ والملاحظات الجديدة بعد ذلك تحتاج إلى فتح القفل لمرة واحدة (الأسعار).

المزامنة وإعادة المزامنة الكاملة

بعد أول «مزامنة الآن»، يُكتب كل تعديل في ملاحظات Apple إلى ملفه ما دام Exporter يعمل، ونافذته مفتوحة أو مغلقة. وإنهاء التطبيق يوقف ذلك؛ ويلحق exporter sync بما فات. وحين تحذف ملاحظة أو تعيد تسميتها أو تنقلها، تحذف المزامنة التالية ملفها القديم، ولا تحذف إلا الملفات المدرجة في .exporter/files.json.

«إعادة مزامنة كاملة» تسأل أولًا، ثم لا تحذف إلا الملفات التي كتبها Exporter، وتصدّر من جديد وتختار الملاحظات المئة المجانية من جديد. وكل ما عدا ذلك في مجلد التصدير يبقى: ملاحظاتك الخاصة، و.obsidian في الخزنة.

المشكلات وحلولها

  • «هذا ليس مجلد ملاحظات Apple»: اخترت مجلدًا آخر. اضغط «المحاولة مرة أخرى»، ثم «اختيار هذا المجلد» دون فتح أي شيء
  • ملاحظة مقفلة مفقودة: أزل القفل في ملاحظات Apple. ويحصي الإعدادات > «تشخيص قاعدة بيانات الملاحظات» الملاحظات المقفلة
  • ملاحظات iCloud مفقودة: افتح ملاحظات Apple ودعه ينهي المزامنة، ثم تحقّق من عدد «محددة» في البطاقة
  • انتقلت الملفات إلى مجلدات أخرى: انتقلت البطاقة إلى علامة تبويب أخرى. عُد إلى علامة التبويب التي تريدها واضغط «مزامنة الآن»
  • فشل تصدير ملاحظة: يعرض «آخر مزامنة» رابط «التفاصيل» باللون الأحمر. «كان تطبيق ملاحظات Apple يكتب هذه الملاحظة وسيتم تصديرها في المزامنة التالية» يزول وحده؛ وإن استمر فشل «تعذّرت قراءة الملاحظة من قاعدة البيانات»، فأرسل التقرير من الإعدادات > «تشخيص قاعدة بيانات الملاحظات» مع عنوان الملاحظة
  • صورة مفقودة: افتح الملاحظة في ملاحظات Apple لينزَّل ملفها، ثم زامن من جديد
  • التعديلات لا تظهر: يجب أن يكون Exporter قيد التشغيل، والملاحظة محدَّدة وضمن الحصة المجانية

Exporter

الإصدار 3.24 (App Store)

macOS 15 أو أحدث

exporter@tinysend.com

© system operator