الكتابة في Markdown

يعمل Markdown جيدًا لملاحظات البحث والتقارير والمسودات المبكرة. يوفر له Oleafly شريط تنسيق مخصصًا ومسار بناء عبر Pandoc، مع ملفات مصدر يمكنك استخدامها خارج التطبيق.

إنشاء تقرير

1. اختر New project → Use a template → Blank Markdown document.
2. سمِّ المشروع ملاحظات ميدانية وافتح main.md.
3. الصق هذا المثال، ثم اختر Recompile أو اضغط ⌘Enter / Ctrl+Enter.
4. إذا عرض Oleafly إعداد محرك لازم، فأكمل ذلك الإعداد ثم جمِّع مرة أخرى.

main.md

---
title: "Field notes"
author: "Alex Chen"
date: ""
---

# Question

Does the revised procedure reduce measurement time?

## Method

1. Prepare the sample.
2. Repeat the measurement three times.
3. Record the elapsed time.

## Observations

| Run | Time (s) | Note |
| --- | --- | --- |
| 1 | 12 | First pass |
| 2 | 10 | Repeated pass |

The **mean time** will be compared with the baseline.

ينبغي أن يتضمن ملف PDF عنوانًا وعناوين وقائمة مرقمة وجدولًا. تتحكم البيانات الوصفية الواقعة بين أول زوج من أسطر --- في عنوان المستند ومؤلفه.

التحرير بالمصدر والتحرير المرئي

لمفتاح بداية شريط الأدوات ثلاثة أوضاع. يحرر Code ترميز Markdown مباشرة. ويمنح Visual تحريرًا منسقًا للعناوين والفقرات والقوائم والروابط والصور والجداول. ويعرض Both المصدر والنص المنسق معًا. افتح قائمته لاختيار Stacked أو Split. تُفتح المشاريع الجديدة في وضع Code، ويتذكر كل مشروع الوضع الذي تركته عليه.

التسطير والتمييز والرمز المرتفع والرمز المنخفض عناصر تنسيق من Pandoc في وضع Code. تكون أزرارها مخفية في وضع Visual. استخدم Code عند العمل على البيانات الوصفية أو صياغة الاستشهادات أو غيرها من مكوّنات المصدر.

تنزيل مصدر المثال

كل أدوات شريط الأدوات

حدِّد نصًا قبل النقر على عنصر تنسيق. في وضع Code، تطوّق معظم الأدوات التحديد أو تُدرج عنصرًا نائبًا. افتح More formatting options (…) للوصول إلى العناصر التي لا تتسع لها الشريط.

Code / Visual

بدّل بين Code وVisual وBoth. يبقى المستند مصدر Markdown في كل وضع.

Undo

يتراجع عن آخر تعديل. ⌘Z / Ctrl+Z.

Redo

يعيد تعديلًا تراجعت عنه. ⌘Shift+Z / Ctrl+Shift+Z.

Heading → Title

اختر Title من قائمة العناوين لإدراج # Title. استبدل نص العنوان بعنوانك الخاص.

Heading → Section

اختر Section من قائمة العناوين لإدراج ## Section. استبدل نص العنوان بعنوانك الخاص.

Heading → Subsection

اختر Subsection من قائمة العناوين لإدراج ### Subsection. استبدل نص العنوان بعنوانك الخاص.

Heading → Subsubsection

اختر Subsubsection من قائمة العناوين لإدراج #### Subsubsection. استبدل نص العنوان بعنوانك الخاص.

Heading → Minor heading

اختر Minor heading من قائمة العناوين لإدراج ##### Minor heading. استبدل نص العنوان بعنوانك الخاص.

Heading → Paragraph heading

اختر Paragraph heading من قائمة العناوين لإدراج ###### Paragraph heading. استبدل نص العنوان بعنوانك الخاص.

Bulleted list

يبدأ قائمة غير مرتبة. - Item.

Numbered list

يبدأ تسلسلًا. 1. Item.

Task list

في وضع Code، أضف مهمة وغيّر [ ] إلى [x] عند إكمالها. - [ ] Task.

Blockquote

ضع اقتباسًا في سطر مستقل. > quoted text.

Bold

يبرز النص المحدد. **text**؛ ⌘B / Ctrl+B.

Italic

يبرز مصطلحًا. *text*؛ ⌘I / Ctrl+I.

Strikethrough

يميز نصًا لم يعد معتمدًا. ~~text~~.

Inline code

ينسّق اسم ملف أو أمرًا أو معرّفًا. نص محاط بعلامات backticks.

Underline

حدِّد عبارة في وضع Code. [text]{.underline}.

Highlight

حدِّد عبارة في وضع Code. [text]{.mark}.

Superscript

حدِّد الأس في وضع Code. ^text^.

Subscript

حدِّد الرمز المنخفض في وضع Code. ~text~.

يستخدم التسطير والتمييز خصائص Pandoc حتى ينتقل التنسيق إلى ملف PDF. استخدم هذين العنصرين بدلًا من إضافة وسوم HTML خام إلى المخطوطة.

Insert link

في وضع Code: يُدرج [link text](url). استبدل العنصرين النائبين.

في وضع Visual: يفتح Link URL. أدخل العنوان وطبّقه على تحديدك. استخدم Remove link للاحتفاظ بالنص دون الرابط.

Insert image

في وضع Code: يُدرج ![caption](image-filename). استبدل المسار والتعليق.

في وضع Visual: يفتح Image file. أدخل مسارًا في المشروع مثل figures/plot.png وطبّقه.

Insert table

في وضع Code: يُدرج ثلاثة أعمدة وصف ترويسة وصفَي بيانات. استبدل أسماء الأعمدة والخلايا.

في وضع Visual: يُدرج جدولًا قابلًا للتحرير بالأبعاد الابتدائية نفسها.

Draw a diagram

يفتح محرر المخططات في وضع Mermaid. ارسم مخطط تدفق على اللوحة أو حرّر شيفرة Mermaid، ثم اختر Insert as Mermaid لإضافته عند المؤشر ككتلة شيفرة mermaid مسوّرة. انظر مخططات Mermaid.

Document insights

يسرد عناوين المستند وأشكاله وجداوله ومعادلاته وتسمياته واستشهاداته وبنود المهام بترتيب المصدر، وكل عنصر منها مرتبط بسطره. كما يقرأ العنوان والمؤلفين والكلمات المفتاحية والتاريخ والملخص من بيانات front matter ويمكنه نسخها لنموذج تقديم. انظر رؤى المستند.

Document settings

يغيّر صنف المستند وحجم الورق والأعمدة والهوامش وخط المتن وحجم الخط واللغة والتباعد بين الأسطر وترقيم الأقسام. يكتب Oleafy اختياراتك في بيانات front matter بصيغة YAML التي يقرؤها Pandoc، ويضيف كتلة بيانات وصفية إن لم يكن في الملف أي منها. انظر إعدادات المستند.

Project info

في وضع Code: يعرض إحصاءات المشروع ومعلومات التحديد.

في وضع Visual: يعرض إحصاءات سطح التحرير المرئي.

Find

في وضع Code: يفتح بحث الملف النشط عبر ⌘F / Ctrl+F.

في وضع Visual: يكون زر Find في شريط المصدر مخفيًا.

استورد الصورة عبر شجرة الملفات قبل الإشارة إليها. أبقِ مسارات الصور نسبية إلى المخطوطة حتى يعمل أرشيف المصدر على حاسوب آخر.

المعادلات وكتل الشيفرة

اكتب الرياضيات السطرية بصيغة $x^2$. وضع معادلة العرض بين زوجين من علامتي الدولار:

$$
\bar{x} = \frac{1}{n}\sum_{i=1}^{n}x_i
$$

للحصول على نموذج شيفرة، ضع الشيفرة بين ثلاث علامات backticks واذكر لغتها بعد العلامة الافتتاحية. هذان مكوّنان من مكوّنات المصدر؛ وليس في شريط أدوات Markdown زر منفصل للمعادلات أو لكتل الشيفرة المسوّرة.

مخططات Mermaid

اختر Draw a diagram في شريط الأدوات لإنشاء مخطط تدفق Mermaid في محرر المخططات. يضيف Insert as Mermaid المخطط ككتلة شيفرة مسوّرة:

```mermaid
flowchart LR
  A[Sample] --> B[Measure]
```

في وضع Both، يرسم الجانب المنسق الكتلة مخططًا. ويحتاج ملف PDF إلى صورة، لذا يحفظ محرر المخططات أيضًا صورة PNG مرسومة في figures/mermaid-<hash>.png، وتضع عملية التجميع تلك الصورة مكان الكتلة. لذلك يظهر المخطط في ملف PDF المجمَّع أيضًا. وإذا حرّرت الكتلة يدويًا بعد ذلك، فسيعرض ملف PDF الشيفرة إلى أن تُدرج المخطط من محرر المخططات من جديد أو تحفظه منه مرة أخرى. انظر Mermaid في مستندات Markdown.

الاستشهادات وقائمة المراجع

استورد ملف references.bib أو أنشئه، وأضف bibliography: references.bib إلى البيانات الوصفية بصيغة YAML، واستشهد بمفتاح موجود بـ [@citation-key]. يستخدم Pandoc قائمة المراجع لإنتاج استشهادات منسقة وقائمة مراجع.

ابحث عن المراجع وأدرها →

الاستيراد والتصدير

للاحتفاظ بمسودة موجودة بترميز Markdown، أنشئ مستند Blank Markdown، والصق المسودة في main.md، ثم استورد صورها وقائمة مراجعها. أما استيراد Markdown document المنفصل في المكتبة فيحوّل المسودة حاليًا إلى LaTeX. يشرح مسارات الاستيراد المسارين.

جمِّع للحصول على PDF، أو استخدم Export لإنشاء Word أو HTML أو Typst أو LaTeX أو نص عادي. واستخدم ملف ZIP للمصدر لمشاركة Markdown الأصل وأصوله. يغطي تصدير عملك التسلسل والفحوص التي تجريها في الملف المحوّل.