دليل صيغة Markdown

مرجع كامل لصيغة Markdown لكتابة مستندات منسقة

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

العناوين

استخدم الرمز # لإنشاء العناوين؛ عدد علامات # يحدد المستوى من H1 إلى H6

Markdown

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

النتيجة

<h1>Heading 1</h1>
<h2>Heading 2</h2>
<h3>Heading 3</h3>
<h4>Heading 4</h4>
<h5>Heading 5</h5>
<h6>Heading 6</h6>

الفقرات وفواصل الأسطر

افصل بين الفقرات بسطر فارغ. لبدء سطر جديد داخل الفقرة نفسها، أضف مسافتين في نهاية السطر ثم اضغط Enter

Markdown

This is paragraph one.

This is paragraph two.

Line one with two spaces at end  
Line two (soft break)

النتيجة

<p>This is paragraph one.</p>
<p>This is paragraph two.</p>
<p>Line one with two spaces at end<br>
Line two (soft break)</p>

التأكيد

ضع النجمات أو الشرطات السفلية حول النص لجعله عريضًا أو مائلًا

Markdown

*Italic* or _italic_
**Bold** or __bold__
***Bold and italic***
~~Strikethrough~~

النتيجة

<em>Italic</em>
<strong>Bold</strong>
<strong><em>Bold and italic</em></strong>
<del>Strikethrough</del>

القوائم

تُدعم القوائم المرقمة وغير المرقمة والقوائم المتداخلة

Markdown

Unordered list:
- Item 1
- Item 2
  - Nested item
  - Another nested

Ordered list:
1. First
2. Second
3. Third

النتيجة

<ul>
<li>Item 1</li>
<li>Item 2
  <ul>
  <li>Nested item</li>
  <li>Another nested</li>
  </ul>
</li>
</ul>
<ol>
<li>First</li>
<li>Second</li>
<li>Third</li>
</ol>

الروابط والصور

اجمع بين الأقواس المربعة والأقواس العادية لإنشاء الروابط وإدراج الصور

Markdown

[Link text](https://example.com)
[Link with title](https://example.com "Title")
![Image alt](https://example.com/image.png)

النتيجة

<a href="https://example.com">Link text</a>
<a href="https://example.com" title="Title">Link with title</a>
<img src="https://example.com/image.png" alt="Image alt">

الشيفرة

علامة ` واحدة للشيفرة داخل السطر، وثلاث علامات ``` لكتل الشيفرة

Markdown

Inline `code` in text.

```javascript
function hello() {
  console.log("Hello!");
}
```

النتيجة

<code>code</code>
<pre><code class="language-javascript">
function hello() {
  console.log("Hello!");
}
</code></pre>

الجداول

استخدم الخطوط العمودية والشرطات لإنشاء الجداول، مع إمكانية ضبط المحاذاة

Markdown

| Header 1 | Header 2 | Header 3 |
|----------|:--------:|---------:|
| Left     | Center   | Right    |
| Cell     | Cell     | Cell     |

النتيجة

<table>
<thead><tr>
<th>Header 1</th>
<th align="center">Header 2</th>
<th align="right">Header 3</th>
</tr></thead>
<tbody>
<tr><td>Left</td><td>Center</td><td>Right</td></tr>
<tr><td>Cell</td><td>Cell</td><td>Cell</td></tr>
</tbody>
</table>

الاقتباسات

استخدم الرمز > لإنشاء كتلة اقتباس، ويمكن تداخل الاقتباسات

Markdown

> This is a blockquote.
> It can span multiple lines.
>
> > Nested blockquote

النتيجة

<blockquote>
<p>This is a blockquote.
It can span multiple lines.</p>
<blockquote><p>Nested blockquote</p></blockquote>
</blockquote>

الخطوط الفاصلة

ثلاث شرطات أو نجمات أو شرطات سفلية أو أكثر ترسم خطًا فاصلًا

Markdown

---
***
___

النتيجة

<hr>

تجاوز الرموز

ضع شرطة مائلة عكسية قبل الرمز الخاص ليظهر كنص عادي

Markdown

\*Not italic\*
\# Not a heading
\[Not a link\]

النتيجة

*Not italic*
# Not a heading
[Not a link]

مرجع سريع

العناوين الفقرات وفواصل الأسطر التأكيد القوائم الروابط والصور الشيفرة الجداول الاقتباسات الخطوط الفاصلة تجاوز الرموز