# اختيار النص الغني مقابل Markdown: كيفية التبديل واستخدام كلا النوعين في بيئة تطبيقات تسجيل الملاحظات الحديثة، يضطر المستخدمون غالبًا إلى اختيار بين فلسفتين مختلفتين: البساطة المحمولة لبرامج النص الغني والواقعية البصرية لبرامج Markdown. معظم التطبيقات تجبرك على اختيار أحدهما. **NoteRich** يخفف من هذا التباين. من خلال تطبيق بنية ثنائية الوضعية متطورة، يسمح NoteRich بالتبديل بسلاسة بين تمثيلات النص الغني وMarkdown لنفس المحتوى، مما يوفر أفضل ما في كلا النوعين دون أي تضحيات. --- ## فهم الوضعيتين قبل البدء في كيفية التبديل بين الوضعيات، من الضروري فهم ما يقدم كل وضعية ومتى يجب استخدامها. ### وضعية النص الغني: التحرير البصري بأفضل شكل يوفر وضعية النص الغني تجربة تحرير **WYSIWYG (ما تراه هو ما تحصل عليه)**. عندما تكون في وضعية النص الغني: - **التنسيق البصري**: الخط المطبع، الخط المائل، العناوين والقوائم تظهر بالضبط كما ستظهر عند العرض - **وصول إلى شريط الأدوات**: شريط تنسيق شامل يوفر وصولًا فوريًا إلى جميع خيارات التصميم - **إدراج الوسائط**: الصور، الجداول، المعادلات والعناصر التفاعلية تظهر داخل النص - **السحب والإسقاط**: إعادة ترتيب المحتوى بسهولة عن طريق سحب الكتل - **قوائم السياق**: إجراءات النقرة اليمنى وشريطات التصميم العائمة تعزز الإنتاجية وضعية النص الغني مناسبة للاستخدام في: - المستخدمين الذين يفضلون التغذية البصرية أثناء الكتابة - المستندات ذات التخطيط المعقد (الجداول، التخطيط متعدد الأعمدة) - جلسات التحرير التعاونية حيث يكون الوضوح البصري مهمًا - التصميم السريع دون الحاجة إلى حفظ الصيغة ### وضعية Markdown: البساطة المحمولة تمثل وضعية Markdown النص كنص عادي مع صيغة تعديل خفيفة. عند العمل في وضعية Markdown: - **محتوى نص عادي قابل للنقل**: تُخزن ملاحظاتك في تنسيق قابل للقراءة عالميًا - **عملية واجراءات باستخدام لوحة المفاتيح**: تنسيق النص باستخدام اختصارات لوحة المفاتيح البسيطة (`**الخط المطبع**، `*الخط المائل*، `# العنوان`) - **متوافق مع التحكم في الإصدارات**: تباينات نظيفة في Git وأنظمة التحكم في الإصدارات الأخرى - **الكتابة السريعة**: لا حاجة للفأرة؛ احتفظ بيديك على لوحة المفاتيح - **التوافق العالمي**: تصدير ومشاركة ملفات `.md` التي تعمل في أي مكان وضعية Markdown مثالية للاستخدام في: - الوثائق التقنية والملاحظات المليئة بالكود - الكتاب الذين يفضلون التحرير البسيط بدون تشتت - إنشاء محتوى طويل مع الحد الأدنى من تكاليف التصميم - المستخدمين الذين يريدون أقصى قدر من القابلية للنقل والتكيف مع المستقبل --- ## البنية الثنائية الوضعيات لا يوفر NoteRich فقط تجارب تحرير منفصلة، بل يخلق **نموذج محتوى موحد** يمكن تمثيله بأي شكل على الفور. يتم ذلك من خلال محرك تحويل متطور يقوم بالتحويل بين البنية الداخلية للوثيقة وصيغة Markdown في الوقت الفعلي. ```mermaid graph TD A[إدخال المستخدم] --> B{نموذج الوثيقة الداخلي} B --> C[تمثيل النص الغني] B --> D[تمثيل Markdown] C --> E[أفعال شريط الأدوات البصرية] C --> F[عمليات السحب والإسقاط] C --> G[تنسيق قوائم السياق] D --> H[تحديد اختصارات Markdown] D --> I[تحديد أنماط الصيغة] D --> J[استيراد/تصدير نص عادي] B --> K[طبقة التخزين الموحدة] K --> L[الحفاظ على datos من خلال IndexedDB] K --> M[حزمة النقل P2P] style A fill:#fafafa,stroke:#eaeaea,color:#333 style B fill:#000,stroke:#000,color:#fff style C fill:#fafafa,stroke:#eaeaea,color:#333 style D fill:#fafafa,stroke:#eaeaea,color:#333 style K fill:#000,stroke:#000,color:#fff ``` هذه البنية تعني أن **محتواك لا يظل محددًا بشكل واحد**. سواء بدأت في كتابة Markdown أو تطبيق التصميم من خلال شريط الأدوات للنص الغني، فإن النموذج الداخلي للوثيقة يظل متسقًا، مما يسمح بالتبديل الفوري دون فقدان البيانات أو تلف التصميم. --- ## كيفية التبديل بين الوضعيات ### الطريقة الأولى: اختيار الوضعية بناءً على الإعدادات يوفر NoteRich إعدادًا عالميًا يحدد الوضعية الافتراضية لجميع الملاحظات: 1. **افتح الإعدادات**: اضغط على رمز المقبض (⚙️) في الزاوية العلوية اليمنى من التطبيق 2. **ابحث عن "النص الغني"**: ابحث عن مؤشر "النص الغني" في لوحة الإعدادات 3. **تبديل الوضعية**: - **مفعول (✓)**: يفتح التطبيق في وضعية النص الغني مع شريط أدوات كامل - **معطل (○)**: يفتح التطبيق في وضعية النص العادي/Markdown ```mermaid sequenceDiagram participant User participant SettingsPanel participant Editor participant DocumentModel User->>SettingsPanel: اضغط على رمز الإعدادات User->>SettingsPanel: تبديل "النص الغني" مؤشر SettingsPanel->>Editor: تحديث مؤشر النص الغني Editor->>DocumentModel: إعادة تقديم بوضعية جديدة Editor-->>User: عرض واجهة محدثة ``` **مهم**: تغيير هذا الإعداد يتطلب تجديد الصفحة للتأثير. هذا يضمن أن جميع البرامج والعناصر في شريط الأدوات يتم تهيئتها بشكل صحيح للوضع المختار. ### الطريقة الثانية: استيراد/تصدير ملاحظات على حدة باستخدام Markdown حتى عند العمل بشكل أساسي في وضعية النص الغني، يمكنك استيراد وتصدير ملاحظات فردية باستخدام Markdown: #### تصدير ملاحظة إلى Markdown 1. افتح الملاحظة التي ترغب في تصديرها 2. اضغط على **قائمة الأفعال** (عادة ما يتم تمثيلها بثلاث نقاط `⋮` أو رمز التحميل) 3. اختر **"تصدير كـ Markdown"** 4. تُحول الملاحظة إلى صيغة Markdown وتُحفظ كملف `.md` يتعامل عملية التصدير بشكل ذكي مع: - **العناوين**: تحويلها إلى `#`، `##`، `###` - **القوائم**: القوائم المعلقة والمرقمة مع التهيئة الصحيحة - **كتل الكود**: تحتفظ بالتحفظات اللغوية (مثلاً، ```javascript) - **الجداول**: تُصرف كجداول Markdown مع علامات التوازي - **الروابط والصور**: تحفظ الروابط مع نص العرض #### استيراد محتوى Markdown 1. قم بإنشاء ملاحظة جديدة أو افتح مسودة موجودة 2. الوصول إلى **وظيفة الاستيراد** من قائمة الأفعال 3. اختر ملف `.md` أو كوّر النص Markdown مباشرة 4. يكتشف NoteRich تلقائيًا صيغة Markdown ويفعل التحويل إلى النموذج الداخلي للوثيقة يستخدم محرك الاستيراد التعرف على الأنماط لتحديد عناصر Markdown: ```markdown Pattern → عنصر النص الغني -------------------------------------------------- # Heading 1 → عقدة Heading H1 ## Heading 2 → عقدة Heading H2 **النص المطبع** → عقدة النص المطبع *النص المائل* → عقدة النص المائل - قطعة القائمة → قطعة القائمة المعلقة 1. قطعة مرقمة → قطعة القائمة المرتبة > الاقتباس → عقدة الاقتباس ```code``` → عقدة كتل الكود [الرابط](url) → عقدة الرابط ![الصورة](url) → عقدة الصورة ``` ### الطريقة الثالثة: اختصارات Markdown في وضعية النص الغني إحدى الميزات القوية لـ NoteRich هي القدرة على استخدام **اختصارات Markdown حتى في وضعية النص الغني**. هذه الطريقة الهجينة تسمح لك بالكتابة بشكل طبيعي مع الاستفادة من سرعة Markdown. عند تفعيل وضعية النص الغني، يقوم كتابة صيغة Markdown بتحويل تلقائي: | كتابة هذا | يصبح هذا | شرط التنفيذ | |-----------------|------------|------------------| | `# ` | H1 Heading | الفاصل بعد العلامة | | `## ` | H2 Heading | الفاصل بعد العلامة المزدوجة | | `### ` | H3 Heading | الفاصل بعد العلامة الثلاثية | | `- ` أو `* ` | قطعة القائمة | الفاصل بعد القوس/الدالة | | `1. ` | قطعة مرقمة | الفاصل بعد الرقم+دالة | | `[] ` | قائمة المربعات | الفاصل بعد الأقواس | | `> ` | الاقتباس | الفاصل بعد الفاصل العالي | | ```` ``` ```` | كتل الكود | ثلاثة علامات+Enter | | `**النص**` | **النص المطبع** | الأقواس الأخيرة | | `*النص*` | *النص المائل* | الأقواس الأخيرة | | `~~النص~~` | ~~النص المشوش~~ | الأقواس الأخيرة | | `` `النص`` `` | `النص المكتبي` | الأقواس الأخيرة | | `[النص](الرابط)` | [الرابط](الرابط) | صيغة الرابط الكاملة | | `---` أو `***` | القاعدة الأفقية | ثلاثة أقواس/دالات | ```mermaid graph LR A[المستخدم يكتب Markdown] --> B[كاشف الأنماط] B -->|تم تطابق النمط| C[تحويل إلى العقدة] B -->|لا تطابق| D[الاحتفاظ كنص عادي] C --> E[تحديث حالة المحرر] E --> F[عرض النص الغني] style A fill:#fafafa,stroke:#eaeaea,color:#333 style B fill:#000,stroke:#000,color:#fff style C fill:#fafafa,stroke:#eaeaea,color:#333 style F fill:#fafafa,stroke:#eaeaea,color:#333 ``` هذا يعني أنك يمكنك الاستمتاع بـ **سرعة كتابة Markdown** مع **مزايا العرض البصري للنص الغني** دون الحاجة إلى تبديل الوضعيات يدويًا. --- ## الميزات المتقدمة: العناصر متعددة السطور يحتوي محرك Markdown في NoteRich على معالجة متطورة للعناصر متعددة السطور، خاصة كتل الكود والاقتباسات. ### كشف كتل الكود يتميز المحرر بتنقيح ذكي بين الكتل الكودية من سطر واحد ومتعددة السطور: ```markdown سطر واحد: ```python print("Hello")``` → حواف الكود المعلقة متعددة السطور: ```python def hello(): print("Hello") ``` → عقدة كتل الكود الكاملة عند استيراد أو كتابة كتل الكود، يقوم NoteRich: 1. اكتشاف الحواف الافتتاحية (``` + معرف اللغة الاختيارية) 2. التقاط كل المحتوى حتى الحواف الختامية 3. الحفاظ على التهيئة والفضاء كما تم كتابته 4. تطبيق التأطير حسب معرف اللغة ### معالجة القوائم المتداخلة تُعاد تركيب القوائم ذات مستويات تهيئة متعددة بشكل صحيح: ```markdown - عنصر المستوى الأول - عنصر المستوى الثاني (4 مسافات تهيئة) - عنصر المستوى الثالث (8 مسافات تهيئة) - العودة إلى المستوى الأول ``` يحسب محرك التحويل مستويات التهيئة ويخلق بنية القائمة المتداخلة المناسبة في نموذج الوثيقة. --- ## اعتبارات الأداء تم تحسين التحويل الثنائي بين النص الغني وMarkdown لأداء عالٍ، حتى مع الوثائق الكبيرة. ### معايير التحويل ```echarts { "xAxis": { "type": "category", "data": ["1k chars", "5k chars", "10k chars", "25k chars", "50k chars"], "axisLabel": { "color": "#666" } }, "yAxis": { "type": "value", "name": "Time (ms)", "splitLine": { "lineStyle": { "color": "#f4f4f5" } }, "axisLabel": { "color": "#666" } }, "series": [ { "name": "Markdown → النص الغني", "data": [8, 15, 22, 35, 48], "type": "line", "smooth": true, "lineStyle": { "color": "#000", "width": 3 }, "itemStyle": { "color": "#000" }, "symbol": "circle", "symbolSize": 8 }, { "name": "النص الغني → Markdown", "data": [5, 10, 16, 28, 38], "type": "line", "smooth": true, "lineStyle": { "color": "#666", "width": 2, "type": "dashed" }, "itemStyle": { "color": "#666" }, "symbol": "circle", "symbolSize": 8 } ], "grid": { "left": "10%", "right": "5%", "bottom": "10%" }, "legend": { "data": ["Markdown → النص الغني", "النص الغني → Markdown"], "bottom": 0, "textStyle": { "color": "#666" } } } ``` حتى مع الوثائق التي تتجاوز 50,000 حرف، ينتهي التحويل في أقل من 50 مللي ثانية—وهو أمر غير ملحوظ للمستخدمين أثناء العمل الطبيعي. ### التحديثات التدريجية بدلاً من إعادة تحليل الوثيقة بأكملها في كل ضغطة مفاتيح، يستخدم NoteRich **التحويل التدريجي**: - **اختصارات Markdown**: يتم تقييم السطر الحالي فقط للبحث عن أنماط - **أفعال شريط الأدوات**: التلاعب بالعقدة مباشرة دون إعادة الترتيب الكامل - **الاستيراد الجماعي**: يتم معالجة ملفات Markdown الكبيرة في أجزاء لتجنب انسداد واجهة المستخدم --- ## أفضل ممارسات اختيار الوضعية ### متى استخدام وضعية النص الغني اختر وضعية النص الغني كوضعية افتراضية عند: 1. **الترتيب البصري مهم**: إنشاء وثائق مع جداول، صور وتنسيقات معقدة 2. **العمل التعاوني**: مشاركة الملاحظات مع أعضاء الفريق الذين يفضلون الأدوات البصرية 3. **تغييرات متكررة في التصميم**: استخدام شريط الأدوات للتعديلات السريعة 4. **الجمهور غير التقني**: إعداد المحتوى للقراء الذين لا يعرفون صيغة Markdown 5. **احتياجات الوصول**: الاعتماد على قراءات الشاشة التي تدعم النصوص المُنسقة بشكل أفضل ### متى استخدام وضعية Markdown اختر وضعية Markdown (أو النص العادي) عند: 1. **الوثائق المليئة بالكود**: كتابة دليلات تقنية مع العديد من أمثلة الكود 2. **تكامل التحكم في الإصدارات**: تتبع التغييرات في مخزون Git 3. **الكتابة بدون تشتت**: تفضيل الواجهات البسيطة بدون أدوات 4. **التوافق متعدد الأجهزة**: استيراد بشكل متكرر إلى أدوات Markdown المتوافقة 5. **عملية تعتمد على لوحة المفاتيح**: الرغبة في الحفاظ على اليدين على لوحة المفاتيح دائمًا ### النهج الهجين: استراتيجية المستخدم المحترف يتبنى العديد من المستخدمين المتمرسين في NoteRich نهج **عملية هجينة**: 1. **تحديد النص الغني كوضعية افتراضية**: الاستمتاع بكل شريط الأدوات والتغذية البصرية 2. **استخدام اختصارات Markdown**: كتابة `#`، `-`، `**النص**` للتعديل السريع 3. **تصدير كـ Markdown**: مشاركة النسخ القابلة للنقل عند الحاجة 4. **استيراد ملفات Markdown**: إدخال المحتوى الخارجي بشكل سلس هذه الطريقة تضمن أقصى قدر من **سرعة الكتابة** و**الوضوح البصري**، مستفيدة من مزايا كلا الوضعيتين. --- ## حل المشكلات الشائعة ### المشكلة: عدم تنفيذ اختصارات Markdown **الأعراض**: كتابة `#` أو `-` لا تحول إلى عنوان أو قائمة **الحلول**: 1. التأكد من تفعيل وضعية النص الغني (تحقق من لوحة الإعدادات) 2. التأكد من نشاط برنامج اختصارات Markdown 3. التحقق من وجود إضافات متنافسة في المتصفح 4. محاولة إضافة فاصل بعد رمز Markdown ### المشكلة: فقدان التصميم أثناء التصدير **الأعراض**: ملف Markdown المصدري يفتقر إلى بعض التصميم **الحلول**: 1. بعض الميزات المتقدمة (الألوان المخصصة، العناصر المضمنة) قد لا تحتوي على مكافئات Markdown 2. فحص الملف المصدري للتأكد من العناصر غير المدعومة 3. استخدام تصدير HTML للوثائق المعقدة بأسلوب تصميم مخصص ### المشكلة: استيراد غير متناسق **الأعراض**: النص المصدري لا يتطابق مع التخطيط المتوقع **الحلول**: 1. التأكد من أن صيغة Markdown تتبع مواصفات CommonMark 2. التحقق من عدم تناسق التهيئة في القوائم 3. التأكد من إغلاق حواف كتل الكود بشكل صحيح 4. اختبار أجزاء أصغر لتمييز الأخطاء النصية ### المشكلة: أداء بطيء مع الوثائق الكبيرة **الأعراض**: تأخر عند الكتابة أو تبديل الوضعيات في ملاحظات طويلة **الحلول**: 1. تفعيل التحويل التدريجي في الإعدادات 2. تقسيم الوثائق الطويلة إلى ملاحظات فرعية مرتبطة 3. تعطيل الإضافات غير الضرورية لوضعية النص العادي 4. استخدام وضعية Markdown للتصميم الأولي، وتبديل إلى النص الغني للتصميم النهائي --- ## مستقبل التحرير الثنائي الوضعيات بنية NoteRich الثنائية الوضعيات تمثل تغييرًا جوهريًا في طريقة تفكيرنا في تحرير الوثائق. بدلاً من اعتبار النص الغني وMarkdown كصيغتين متنافستين، يجمع NoteRichهما في **نموذج محتوى موحد** يمكن تكيفه مع عملك. تشمل التحسينات المستقبلية: - **إعدادات وضعية الملاحظة لكل ملاحظة**: تغيير الإعدادات العالمية للملاحظات الفردية - **التعاون الفوري**: رؤية اختصارات Markdown للتعاون مع المستخدمين على الفور - **التحويل بمساعدة الذكاء الاصطناعي**: اقتراحات ذكية لتحسين اختيارات التصميم - **المحولات المخصصة**: تحديد معاملات Markdown إلى النص الغني الخاصة بك --- ## الخلاصة اختيار النص الغني أو Markdown لا يجب أن يكون اختيارًا أحادي الاتجاه. مع البنية الثنائية المبتكرة لـ NoteRich، تحصل على: ✅ **الثراء البصري** عند الحاجة إليه ✅ **بساطة النص العادي** عند رغبتك فيه ✅ **التبديل السلس** بين النوعين ✅ **اختصارات Markdown** في وضعية النص الغني ✅ **التوافق الكامل** مع أدوات Markdown خارجية سواء كنت مطورًا يسجل الكود، كاتبًا يصنع محتوى طويل، أو عاملًا معرفيًا يدير مشاريع معقدة، يخدمك NoteRich وفقًا لعملية تحريرك المفضلة دون إجبارك على التضحية. ابدأ بالوضعية التي تعتبر الأكثر ملاءمة لك، جرّب اختصارات Markdown، واكتشف التوازن المثالي لاحتياجاتك الفريدة. ملاحظاتك، بطريقتك. --- ##<div class="flex flex-wrap gap-2 mt-8 mb-12"> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">النص الغني</span> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">Markdown</span> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">الوضعية الثنائية</span> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">WYSIWYG</span> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">الاختصارات</span> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">الإنتاجية</span> </div> ```