الشيفرات والصيغ والمخططات

لا تقتصر الملاحظات على النصوص. يمكنك حفظ أمر تنساه دائمًا، أو كتابة صيغة رياضية بتنسيق واضح، أو تمثيل عملية بمخطّط، كل ذلك في الملاحظة نفسها. ويُعرَض المحتوى على Mac دون اتصال بالإنترنت.

شيفرة ضمن السطر

ضع الأمر القصير أو اسم الملف أو الإعداد بين علامتَي اقتباس خلفيتين، أو حدّده واضغط على ⌥⌘C:

Restart the router, then run `ping 1.1.1.1` to check.

كتل الشيفرة

لعدة أسطر، استخدم كتلة شيفرة. اضغط على ⌃⌘C، أو اكتب ثلاث علامات اقتباس خلفية في سطر مستقل. يضيف Varlig علامات الإغلاق ويقترح لغة برمجة. ويؤدي اختيار لغة، مثل python أو swift، إلى تلوين الشيفرة بحسب بنيتها.

```python
for item in packing_list:
    print(item)
```

ينسخ زر Copy Code بجانب الكتلة محتواها دون علامات الاقتباس الخلفية. وتبقى السطور التي تحمل علامات الاقتباس الخلفية مخفية إلا عندما يكون المؤشر داخل الكتلة.

لغتان مميزتان: تحول calc الكتل إلى آلة حاسبة (انظر حسابك الأول)، وmermaid ترسم مخططًا، كما هو موضح أدناه.

الأسطر الطويلة

تُلتفّ سطور الشيفرة الطويلة افتراضيًا لتناسب العرض. أما Settings › Editor › Scroll long code lines instead of wrapping فيُبقي كل سطر على صف واحد ويتيح تمريره أفقيًا. تشير … إلى وجود تتمّة للسطر، ويُظهر تحريك المؤشر على امتداد السطر بقية النص، كما يمرّر السحب الجانبي فوق الكتلة محتواها. لا يتغيّر نص الملاحظة أبدًا ولا تُدرج فيه محارف إضافية؛ وعند نسخ الكتلة أو تصديرها تحصل على ما كتبته بالضبط.

الصيغ الرياضية

اكتب الصيغ الرياضية بترميز TeX. أحط الصيغة بعلامة دولار واحدة من كل جانب لتظهر داخل الجملة (Format › Math Formula)، أو ضع علامتي دولار قبلها وبعدها في سطرين مستقلّين لعرضها ككتلة (Format › Math Block):

The area of a circle is $\pi r^2$.

$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$

عندما تضع المؤشر داخل صيغة رياضية، ترى نصها المصدري مع معاينة تتحدّث أثناء الكتابة. يدعم Varlig أوامر TeX الشائعة، وإذا لم يتعرّف إلى أمر، يعرض رسالة خطأ بدلًا من الصيغة.

تعرض الصيغة الرموز الرياضية فقط. ولحساب نتيجة، استخدم كتلة حسابات.

مخطّطات Mermaid

صف مخططًا انسيابيًا أو خطًا زمنيًا أو رسمًا آخر بالنص، ليرسمه Varlig داخل الملاحظة. اختر Format › Mermaid Diagram لإدراج مثال أولي، أو اكتب كتلة mermaid:

```mermaid
flowchart LR
  Idea --> Plan --> Done
```

يحدّد السطر الأول نوع الرسم. يرسم Varlig المخططات الانسيابية (flowchart أو graph) وsequenceDiagram وclassDiagram وstateDiagram وerDiagram وpie وgantt وjourney وtimeline وmindmap وgitGraph وquadrantChart وxychart وsankey وkanban وغيرها. عدّل النص ليتحدّث الرسم تبعًا له.

يمكن أن يحتوي الرسم البياني على ما يصل إلى 512 سطرا و256 صندوقا و512 اتصالا.

ترويسة البيانات الوصفية بصيغة YAML

تقرأ بعض الأدوات البيانات الوصفية من أعلى ملف Markdown. اختر Format › YAML Front Matter لإضافة كتلة بين سطرين --- في بداية الملاحظة مباشرةً:

---
project: Kitchen
status: planning
---

يحتفظ Varlig بترويسة البيانات الوصفية كما تكتبها تمامًا، ويستخدم أول سطر بعدها عنوانًا للملاحظة.

HTML

يعرض Varlig علامات HTML كنص بدلا من تحويلها إلى تنسيق. الاستثناء الوحيد هو <br>، الذي يبدأ سطرا جديدا.