تعلّم كيفية تطبيق التنسيق الأساسي على ملاحظاتك باستخدام [Markdown](https://daringfireball.net/projects/markdown/). لمزيد من صيغ التنسيق المتقدمة، راجع [[صيغة التنسيق المتقدم|صيغة التنسيق المتقدمة]].
## الفقرات
لإنشاء فقرات في Markdown، استخدم **سطرًا فارغًا** للفصل بين كتل النص. كل كتلة نص مفصولة بسطر فارغ تُعامل كفقرة مستقلة.
```md
This is a paragraph.
This is another paragraph.
```
This is a paragraph.
This is another paragraph.
السطر الفارغ بين أسطر النص يُنشئ فقرات منفصلة. هذا هو السلوك الافتراضي في Markdown.
> [!tip]- المسافات الفارغة المتعددة
> المسافات الفارغة المتعددة المتجاورة داخل الفقرات وبينها تُختصر إلى مسافة واحدة عند عرضها في [[العروض ووضع التحرير#عرض القراءة|عرض القراءة]] أو على مواقع [[مقدمة عن Obsidian Publish|Obsidian Publish]].
>
> ```md
> Multiple adjacent spaces
>
>
>
> and multiple newlines between paragraphs.
> ```
>
> > Multiple adjacent spaces
> >
> >
> >
> > and multiple newlines between paragraphs.
>
> إذا كنت تريد منع المسافات من الاختصار أو إضافة مسافات فارغة متعددة، يمكنك استخدام وسم ` ` (مسافة غير قابلة للكسر) أو وسم `<br>` (كسر السطر) في HTML.
### فواصل الأسطر
بشكل افتراضي في Obsidian، الضغط على `Enter` مرة واحدة يُنشئ سطرًا جديدًا في ملاحظتك، لكن يُعامل كـ*استمرار* للفقرة نفسها في المخرجات المُقدَّمة، وفقًا لسلوك Markdown المعتاد. لإدراج فاصل سطر *داخل* فقرة دون بدء فقرة جديدة، يمكنك إما:
- إضافة **مسافتين** في نهاية السطر قبل الضغط على `Enter`، أو
- استخدام الاختصار `Shift+Enter` لإدراج فاصل سطر مباشرة.
> [!question]- لماذا لا يُنشئ الضغط المتعدد على `Enter` المزيد من فواصل الأسطر في عرض القراءة؟
> في Markdown، يتم تجاهل `Enter` واحد، والضغطات المتتالية المتعددة على `Enter` تؤدي إلى فقرة جديدة واحدة فقط. يتوافق هذا السلوك مع قاعدة الالتفاف الناعم في Markdown، حيث لا تُولّد الأسطر الفارغة الإضافية فواصل أسطر أو فقرات إضافية — بل تُختصر إلى فاصل فقرة واحد. هذه هي الطريقة التي يتعامل بها Markdown مع النص افتراضيًا، مما يضمن تدفق الفقرات بشكل طبيعي دون فواصل غير متوقعة.
يتضمن Obsidian إعداد **[[الإعدادات#فواصل الأسطر الصارمة|فواصل الأسطر الصارمة]]**، الذي يجعل Obsidian يتبع مواصفات Markdown القياسية لفواصل الأسطر.
لتمكين هذه الميزة:
1. افتح **[[الإعدادات|الإعدادات]]**.
2. انتقل إلى علامة تبويب **المحرر**.
3. مكّن **فواصل الأسطر الصارمة**.
عند تمكين **فواصل الأسطر الصارمة** في Obsidian، يكون لفواصل الأسطر ثلاثة سلوكيات مختلفة حسب طريقة فصل الأسطر:
**إدخال واحد بدون مسافات**: `Enter` واحد بدون مسافات لاحقة سيدمج السطرين المنفصلين في سطر واحد عند العرض.
```md
line one
line two
```
يُعرض كالتالي:
line one line two
**إدخال واحد مع مسافتين لاحقتين أو أكثر**: إذا أضفت مسافتين أو أكثر في نهاية السطر الأول قبل الضغط على `Enter`، يبقى السطران جزءًا من نفس الفقرة، لكنهما مفصولان بفاصل سطر (عنصر HTML `<br>`). سنستخدم شرطتين سفليتين للإشارة إلى المسافات في هذا المثال.
```md
line three__
line four
```
يُعرض كالتالي:
line three<br>
line four
**إدخال مزدوج (مع أو بدون مسافات لاحقة)**: الضغط على `Enter` مرتين (أو أكثر) يفصل الأسطر إلى فقرتين مستقلتين (عناصر HTML `<p>`)، بغض النظر عما إذا أضفت مسافات في نهاية السطر الأول.
```md
line five
line six
```
يُعرض كالتالي:
<p>line five</p>
<p>line six</p>
## العناوين
لإنشاء عنوان، أضف ما يصل إلى ستة رموز `#` قبل نص العنوان. عدد رموز `#` يحدد مستوى العنوان (كما هو موضح في [[المخطط|المخطط التفصيلي]]).
```md
# This is a heading 1
## This is a heading 2
### This is a heading 3
#### This is a heading 4
##### This is a heading 5
###### This is a heading 6
```
%% These headings use HTML to avoid cluttering the Outline/Table of contents %%
<h1>هذا عنوان 1</h1>
<h2>هذا عنوان 2</h2>
<h3>هذا عنوان 3</h3>
<h4>هذا عنوان 4</h4>
<h5>هذا عنوان 5</h5>
<h6>هذا عنوان 6</h6>
## عريض، مائل، تمييز
يمكن أيضًا تطبيق تنسيق النص باستخدام [[اختصارات التحرير|اختصارات التحرير]].
| النمط | الصيغة | مثال | المخرجات |
|-|-|-|-|
| عريض | `** **` أو `__ __` | `**Bold text**` | **Bold text** |
| مائل | `* *` أو `_ _` | `*Italic text*` | *Italic text* |
| يتوسطه خط | `~~ ~~` | `~~Striked out text~~` | ~~Striked out text~~ |
| تمييز | `== ==` | `==Highlighted text==` | ==Highlighted text== |
| عريض ومائل متداخل | `** **` و `_ _` | `**Bold text and _nested italic_ text**` | **Bold text and _nested italic_ text** |
| عريض ومائل | `*** ***` أو `___ ___` | `***Bold and italic text***` | ***Bold and italic text*** |
يمكن إجبار التنسيق على الظهور كنص عادي بإضافة شرطة مائلة عكسية `\` أمامه.
\*\*This line will not be bold\*\*
```markdown
\*\*This line will not be bold\*\*
```
\**This line will be italic and show the asterisks*\*
```markdown
\**This line will be italic and show the asterisks*\*
```
## الروابط الداخلية
يدعم Obsidian صيغتين لـ[[روابط داخلية|الروابط الداخلية]] بين الملاحظات:
- رابط ويكي: `[[Three laws of motion]]`
- Markdown: `[Three laws of motion](Three%20laws%20of%20motion.md)`
## الروابط الخارجية
إذا كنت تريد الربط بعنوان URL خارجي، يمكنك إنشاء رابط مضمّن بإحاطة نص الرابط بأقواس مربعة (`[ ]`)، ثم العنوان بأقواس دائرية (`( )`).
```md
[Obsidian Help](https://help.obsidian.md)
```
[Obsidian Help](https://help.obsidian.md)
يمكنك أيضًا إنشاء روابط خارجية لملفات في خزائن أخرى، بالربط بـ[[Obsidian URI|عنوان URI في Obsidian]].
```md
[Note](obsidian://open?vault=MainVault&file=Note.md)
```
### تخطي المسافات الفارغة في الروابط
إذا كان عنوان URL الخاص بك يحتوي على مسافات فارغة، يجب تخطيها باستبدالها بـ`%20`.
```md
[My Note](obsidian://open?vault=MainVault&file=My%20Note.md)
```
يمكنك أيضًا تخطي عنوان URL بإحاطته بأقواس زاوية (`< >`).
```md
[My Note](<obsidian://open?vault=MainVault&file=My Note.md>)
```
## الصور الخارجية
يمكنك إضافة صور بعناوين URL خارجية، بإضافة رمز `!` قبل [[#الروابط الخارجية|رابط خارجي]].
```md
```
يمكنك تغيير أبعاد الصورة بإضافة `|640x480` إلى وجهة الرابط، حيث 640 هو العرض و480 هو الارتفاع.
```md
```
إذا حددت العرض فقط، تتغير أبعاد الصورة وفقًا لنسبة العرض إلى الارتفاع الأصلية. على سبيل المثال:
```md
```
> [!tip]- نصيحة
> إذا كنت تريد إضافة صورة من داخل خزنتك، يمكنك أيضًا [[تضمين الملفات#تضمين صورة في ملاحظة|تضمين صورة في ملاحظة]].
## الاقتباسات
يمكنك اقتباس النص بإضافة رمز `>` قبل النص.
```md
> Human beings face ever more complex and urgent problems, and their effectiveness in dealing with these problems is a matter that is critical to the stability and continued progress of society.
\- Doug Engelbart, 1961
```
> Human beings face ever more complex and urgent problems, and their effectiveness in dealing with these problems is a matter that is critical to the stability and continued progress of society.
\- Doug Engelbart, 1961
> [!tip]- نصيحة
> يمكنك تحويل اقتباسك إلى [[القصاصات|مربع تنبيه]] بإضافة `[!info]` كأول سطر في الاقتباس.
## القوائم
يمكنك إنشاء قائمة غير مرتبة بإضافة `-` أو `*` أو `+` قبل النص.
```md
- First list item
- Second list item
- Third list item
```
- First list item
- Second list item
- Third list item
لإنشاء قائمة مرتبة، ابدأ كل سطر برقم متبوع برمز `.` أو `)`.
```md
1. First list item
2. Second list item
3. Third list item
```
1. First list item
2. Second list item
3. Third list item
```md
1) First list item
2) Second list item
3) Third list item
```
1) First list item
2) Second list item
3) Third list item
يمكنك استخدام `Shift+Enter` لإدراج [[#فواصل الأسطر|فاصل سطر]] داخل قائمة مرتبة دون تغيير الترقيم.
```md
1. First list item
2. Second list item
3. Third list item
4. Fourth list item
5. Fifth list item
6. Sixth list item
```
### قوائم المهام
لإنشاء قائمة مهام، ابدأ كل عنصر في القائمة بشرطة ومسافة متبوعة بـ`[ ]`.
```md
- [x] This is a completed task.
- [ ] This is an incomplete task.
```
- [x] This is a completed task.
- [ ] This is an incomplete task.
يمكنك تبديل حالة المهمة في عرض القراءة بتحديد مربع الاختيار.
> [!tip]- نصيحة
> يمكنك استخدام أي حرف داخل الأقواس لتعليمها كمكتملة.
>
> ```md
> - [x] Milk
> - [?] Eggs
> - [-] Eggs
> ```
>
> - [x] Milk
> - [?] Eggs
> - [-] Eggs
### القوائم المتداخلة
يمكنك تداخل أي نوع من القوائم — مرتبة، غير مرتبة، أو قوائم مهام — تحت أي نوع آخر من القوائم.
لإنشاء قائمة متداخلة، أضف مسافة بادئة لعنصر واحد أو أكثر من عناصر القائمة. يمكنك مزج أنواع القوائم ضمن بنية متداخلة:
```md
1. First list item
1. Ordered nested list item
2. Second list item
- Unordered nested list item
```
1. First list item
1. Ordered nested list item
2. Second list item
- Unordered nested list item
بالمثل، يمكنك إنشاء قائمة مهام متداخلة بإضافة مسافة بادئة لعنصر واحد أو أكثر من عناصر القائمة:
```md
- [ ] Task item 1
- [ ] Subtask 1
- [ ] Task item 2
- [ ] Subtask 1
```
- [ ] Task item 1
- [ ] Subtask 1
- [ ] Task item 2
- [ ] Subtask 1
استخدم `Tab` أو `Shift+Tab` لإضافة مسافة بادئة أو إلغائها للعناصر المحددة في القائمة لتنظيمها بسهولة.
## خط فاصل
يمكنك استخدام ثلاث نجوم أو أكثر `***`، أو شرطات `---`، أو شرطات سفلية `___` في سطر خاص بها لإضافة خط أفقي. يمكنك أيضًا فصل الرموز باستخدام مسافات.
```md
***
****
* * *
---
----
- - -
___
____
_ _ _
```
***
## الشيفرة المصدرية
يمكنك تنسيق الشيفرة المصدرية سواء مضمّنة داخل جملة، أو في كتلة خاصة بها.
### شيفرة مصدرية مضمّنة
يمكنك تنسيق الشيفرة المصدرية داخل جملة باستخدام علامات اقتباس خلفية مفردة.
```md
Text inside `backticks` on a line will be formatted like code.
```
Text inside `backticks` on a line will be formatted like code.
إذا كنت تريد وضع علامات اقتباس خلفية في كتلة شيفرة مصدرية مضمّنة، أحطها بعلامات اقتباس خلفية مزدوجة كالتالي: inline ``code with a backtick ` inside``.
### كتل التعليمات البرمجية
لتنسيق الشيفرة المصدرية ككتلة، أحطها بثلاث علامات اقتباس خلفية أو أكثر أو ثلاث علامات تيلدا أو أكثر.
~~~
`````
cd ~/Desktop
`````
~~~
`````
~~~
cd ~/Desktop
~~~
`````
`````md
cd ~/Desktop
`````
يمكنك أيضًا إنشاء كتلة تعليمات برمجية بإضافة مسافة بادئة للنص باستخدام `Tab` أو 4 مسافات فارغة.
`````md
cd ~/Desktop
`````
يمكنك إضافة تمييز بناء الجملة لكتلة التعليمات البرمجية، بإضافة رمز اللغة بعد المجموعة الأولى من علامات الاقتباس الخلفية.
~~~md
`````js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
`````
~~~
`````js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
`````
يستخدم Obsidian مكتبة Prism لتمييز بناء الجملة. لمزيد من المعلومات، راجع [اللغات المدعومة](https://prismjs.com/#supported-languages).
> [!info]+ PrismJS وأوضاع التحرير
> لا يدعم [[العروض ووضع التحرير#وضع المصدر|وضع المصدر]] و[[العروض ووضع التحرير#معاينة مباشرة|معاينة مباشرة]] مكتبة PrismJS، وقد يعرضان تمييز بناء الجملة بشكل مختلف.
#### تداخل كتل التعليمات البرمجية
عندما تحتاج إلى تضمين كتلة تعليمات برمجية داخل كتلة تعليمات برمجية أخرى (على سبيل المثال، عند توثيق كيفية استخدام كتل التعليمات البرمجية)، يمكنك استخدام أكثر من ثلاث علامات اقتباس خلفية أو تيلدا للكتلة الخارجية.
لتداخل كتل التعليمات البرمجية، استخدم أربع علامات اقتباس خلفية أو أكثر (أو تيلدا) للكتلة الخارجية، بينما تستخدم الكتلة الداخلية ثلاثًا:
`````md
````md
Here's how to create a code block:
```js
console.log("Hello world")
```
````
`````
يمكنك أيضًا مزج علامات الاقتباس الخلفية والتيلدا. هذا مفيد بشكل خاص عند العمل مع شيفرة تُولّد كتل تعليمات برمجية أخرى:
`````md
````md
```dataviewjs
dv.paragraph(`
~~~mermaid
graph TD
A --> B
~~~
`)
```
````
`````
المبدأ الأساسي هو أن كتلة التعليمات البرمجية الخارجية يجب أن تستخدم عددًا **أكبر** من أحرف السياج (علامات الاقتباس الخلفية أو التيلدا) من أي كتلة تعليمات برمجية داخلية، أو تستخدم نوعًا مختلفًا من أحرف السياج.
## الحواشي السفلية
يمكنك إضافة حواشي سفلية[^footnote] إلى ملاحظاتك باستخدام الصيغة التالية:
[^footnote]: هذه حاشية سفلية.
```md
This is a simple footnote[^1].
[^1]: This is the referenced text.
[^2]: Add 2 spaces at the start of each new line.
This lets you write footnotes that span multiple lines.
[^note]: Named footnotes still appear as numbers, but can make it easier to identify and link references.
```
يمكنك أيضًا إدراج حواشي سفلية مضمّنة في جملة. لاحظ أن علامة الإقحام تقع خارج الأقواس.
```md
You can also use inline footnotes. ^[This is an inline footnote.]
```
> [!note] ملاحظة
> تعمل الحواشي السفلية المضمّنة فقط في عرض القراءة، وليس في معاينة مباشرة.
استخدم [[عرض الحواشي السفلية]] لرؤية جميع الحواشي السفلية في ملاحظة.
## التعليقات
يمكنك إضافة تعليقات بإحاطة النص بـ`%%`. التعليقات مرئية فقط في وضع التحرير.
```md
This is an %%inline%% comment.
%%
This is a block comment.
Block comments can span multiple lines.
%%
```
## تخطي صيغة Markdown
في بعض الحالات، قد تحتاج إلى عرض أحرف خاصة في Markdown، مثل `*` أو `_` أو `#`، دون تفعيل تنسيقها. لعرض هذه الأحرف حرفيًا، ضع شرطة مائلة عكسية (`\`) قبلها.
> [!example] الأحرف الشائعة التي يجب تخطيها
>
> - نجمة: `\*`
> - شرطة سفلية: `\_`
> - علامة المربع: `\#`
> - علامة اقتباس خلفية: `` \` ``
> - خط عمودي (يُستخدم في الجداول): `\|`
> - تيلدا: `\~`
```md
\*This text will not be italicized\*.
```
\*This text will not be italicized\*.
عند العمل مع القوائم المرقمة، قد تحتاج إلى تخطي النقطة بعد الرقم لمنع التنسيق التلقائي للقائمة. ضع الشرطة المائلة العكسية (`\`) قبل النقطة، **وليس** قبل الرقم.
```md
1\. This won't be a list item.
```
1\. This won't be a list item.
## تعلم المزيد
لمعرفة المزيد عن صيغ التنسيق المتقدمة، مثل الجداول والرسوم البيانية والتعبيرات الرياضية، راجع [[صيغة التنسيق المتقدم|صيغة التنسيق المتقدمة]].
لمعرفة المزيد عن كيفية تحليل Obsidian لـ Markdown، راجع [[Markdown بنكهة Obsidian]].