# الكتابة في Markdown

سوِّد بترميز Markdown المألوف وأنتج ملف PDF أو مستندًا قابلًا للتحرير للمتعاونين.

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

## إنشاء تقرير

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

```markdown title="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 عند العمل على البيانات الوصفية أو صياغة الاستشهادات أو غيرها من مكوّنات المصدر.

[تنزيل مصدر المثال](/examples/writing-example.md)

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

حدِّد نصًا قبل النقر على عنصر تنسيق. في وضع 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

يفتح [محرر المخططات](/docs/figures-diagrams/) في وضع Mermaid. ارسم مخطط تدفق على اللوحة أو حرّر شيفرة Mermaid، ثم اختر **Insert as Mermaid** لإضافته عند المؤشر ككتلة شيفرة `mermaid` مسوّرة. انظر [مخططات Mermaid](#mermaid-diagrams).

### Document insights

يسرد عناوين المستند وأشكاله وجداوله ومعادلاته وتسمياته واستشهاداته وبنود المهام بترتيب المصدر، وكل عنصر منها مرتبط بسطره. كما يقرأ العنوان والمؤلفين والكلمات المفتاحية والتاريخ والملخص من بيانات front matter ويمكنه نسخها لنموذج تقديم. انظر [رؤى المستند](/docs/document-insights/).

### Document settings

يغيّر صنف المستند وحجم الورق والأعمدة والهوامش وخط المتن وحجم الخط واللغة والتباعد بين الأسطر وترقيم الأقسام. يكتب Oleafy اختياراتك في بيانات front matter بصيغة YAML التي يقرؤها Pandoc، ويضيف كتلة بيانات وصفية إن لم يكن في الملف أي منها. انظر [إعدادات المستند](/docs/document-settings/#markdown).

### Project info

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

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

### Find

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

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

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

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

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

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

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

## مخططات Mermaid

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

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

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

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

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

[ابحث عن المراجع وأدرها →](/docs/citations/)

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

للاحتفاظ بمسودة موجودة بترميز Markdown، أنشئ مستند Blank Markdown، والصق المسودة في `main.md`، ثم استورد صورها وقائمة مراجعها. أما استيراد **Markdown document** المنفصل في المكتبة فيحوّل المسودة حاليًا إلى LaTeX. يشرح [مسارات الاستيراد](/docs/import-project/) المسارين.

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