راهنمای نحو 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
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]