Markdown في لمحة

كل ملاحظة في Varlig مكتوبة بصيغة Markdown العادية، باستخدام رموز بسيطة للعناوين والقوائم وتنسيق النص. اكتب الرموز أو استخدم قائمة Format واختصاراتها، وسينسّق Varlig الملاحظة أثناء الكتابة. تجمع هذه الصفحة الأساسيات في مكان واحد مع روابط للتفاصيل.

هل تستخدم Markdown لأول مرة؟ يشرح دليل ملاحظتك الأولى الأساسيات خطوة بخطوة.

ملاحظة واحدة وتنسيقات Markdown متنوّعة

إليك ملاحظة واحدة تستخدم القليل من كل شيء. الجانب الأيسر هو بالضبط ما تم حفظه؛ الجانب الأيمن هو ما تراه في Varlig.

# Lisbon weekend
Flights are **booked** and the hotel is ==paid==. #travel/portugal

## Before we go
- [x] Book the hotel
- [ ] Download the offline map
- [ ] Read [[Lisbon bookings]]

> [!TIP] Tram 28
> Board at the first stop to get a seat.

| Day      | Plan              |
| -------- | ----------------- |
| Saturday | Castle and Alfama |
| Sunday   | Belém             |

```calc
hotel = €145 * 2
hotel / 2
```

كيفية عرض Varlig لتنسيقات Markdown

يخفي Varlig رموز التنسيق لتقرأ الملاحظة بسهولة، ثم يُظهرها عندما تحتاج إليها:

• التنسيقات والروابط: تبقى الرموز ** و_ و~ و== والأقواس مخفية حتى تضع المؤشر داخل النص المنسّق أو يشمله جزء من التحديد.
• العناوين: علامات # مخفية دائما. تظهر أيقونة في الهامش المستوى أثناء وجود المؤشر في العنوان.
• القوائم: تظهر علامات القوائم غير المرقّمة كنقاط، والمهام كمربعات اختيار، وتبقى الأرقام كما هي.
• تُبقي الاقتباسات الرمز > بلون خافت، بينما تُخفي المربعات التنبيهية علامة [!TIP] حتى تضع المؤشر داخلها.
• تُخفي كتل الشيفرة والحسابات أسطر علامات الاقتباس الخلفية حتى تضع المؤشر داخل الكتلة.
• تُعرَض الجداول والصور والفواصل في مواضعها، ويظهر نص Markdown الخاص بها أثناء فتح Find ‏(⌘F).
• تظهر الوسوم على شكل شارات صغيرة مستديرة الأطراف.

للعثور على Markdown الكامل للملاحظة، افتح قائمة … للملاحظة واختر Copy As › Markdown، ثم الصقه في أي مكان.

مرجع سريع

النص

البنية

القوائم

الروابط والوسوم

الكتل

الصور والملفات

عدد الكلمات والأهداف

يعرض View › Show Word Count عدّادًا أسفل المحرّر. وإذا حدّدت نصًا، يحسب التحديد بدلًا من الملاحظة كاملة. ولا تُحتسَب رموز Markdown.

يتيح Note › Set Writing Target… تحديد هدف لملاحظة واحدة بعدد Words أو Characters. وتعرض الشارة التقدّم نحوه، مثل 312 of 500 words · 188 to go ثم Target reached. يؤدي ضبط الهدف إلى إظهار الشارة لهذه الملاحظة سواء كان عدّاد الكلمات مفعّلًا أم لا، ويزيلها Remove Target.

يتم حساب الأحرف كما يراها القارئ: كل حرف أو رقم أو علامة ترقيم أو رمز تعبيري مرة واحدة، بالإضافة إلى مسافة واحدة بين الكلمات على سطر. لا يتم احتساب بناء جملة Markdown والمسافات الإضافية وفواصل الأسطر، لذا فإن إعادة تنسيق الملاحظة لا تغير القيمة العددية أبدا. مع هدف الحرف، يتم حساب التحديد بالأحرف أيضا.

يُبقي View › Typewriter Scrolling السطر الذي تكتب فيه في منتصف المحرّر رأسيًا. يتحرّك العرض أثناء الكتابة أو الحذف فقط، فيظل التحديد والتمرير اليدوي يعملان كالمعتاد.

ملاحظات في علامات التبويب

يمكن فتح ملاحظة في نافذة مستقلة (File › New Note in New Window، ‏⌥⌘N) أو في تبويب داخلها (File › New Note in New Tab، ‏⌃⌘N). ويؤدي زر + في شريط التبويبات وأمر New Tab في macOS الوظيفة نفسها. يمكنك سحب نافذة ملاحظة إلى شريط تبويبات نافذة أخرى، أو استخدام Window › Merge All Windows لجمع الملاحظات التي تعمل عليها في نافذة واحدة.

يعمل كل تبويب كنافذة كاملة، ويحتفظ عند التبديل بموضع المؤشر والتحديد والتمرير لكل ملاحظة كما تركتها تمامًا. تظهر الملاحظة المحمية المقفلة باسم Protected note في شريط التبويبات، ولا يؤدي قفلها إلى إغلاق تبويبها.

لا تدعم نافذة المكتبة نفسها علامات التبويب؛ فهي تضم الشريط الجانبي وقائمة الملاحظات، ولا توجد منها سوى نافذة واحدة.

المفاتيح أثناء الكتابة

• يواصل Return القائمة العادية أو المرقّمة أو الاقتباس. وعند الضغط عليه في عنصر فارغ، يخرج من المستوى الحالي.
• يزيد Tab المسافة البادئة لعناصر القوائم والشيفرة، ويقلّلها Shift-Tab.
• تفتح # و**[[** و**:** اقتراحات للوسوم وعناوين الملاحظات والرموز التعبيرية، على الترتيب. استخدم مفاتيح الأسهم ثم Return أو Tab لاختيار اقتراح.
• يعرض Escape داخل كتلة حسابات اقتراحات لأسماء الدوال.

كل اختصار موجود في صفحة اختصارات لوحة المفاتيح.