یاد بگیرید چگونه قالببندی پایه را با استفاده از [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.
>
> اگر میخواهید از جمع شدن فاصلهها جلوگیری کنید یا چندین فاصله خالی اضافه کنید، میتوانید از تگهای HTML مانند ` ` (فاصله غیرشکننده) یا `<br>` (شکست خط) استفاده کنید.
### شکست خط
به صورت پیشفرض در 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>این یک سرفصل ۱ است</h1>
<h2>این یک سرفصل ۲ است</h2>
<h3>این یک سرفصل ۳ است</h3>
<h4>این یک سرفصل ۴ است</h4>
<h5>این یک سرفصل ۵ است</h5>
<h6>این یک سرفصل ۶ است</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 خارجی پیوند دهید، میتوانید یک پیوند درونخطی ایجاد کنید، به این صورت که متن پیوند را در کروشه (`[ ]`) و سپس URL را در پرانتز (`( )`) قرار دهید.
```md
[Obsidian Help](https://help.obsidian.md)
```
[Obsidian Help](https://help.obsidian.md)
همچنین میتوانید با پیوند دادن به یک [[Obsidian URI|Obsidian URI]]، پیوندهای خارجی به فایلهای موجود در گاوصندوقهای دیگر ایجاد کنید.
```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` یا ۴ فاصله خالی، یک بلوک کد ایجاد کنید.
`````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]: This is a 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.
## اطلاعات بیشتر
برای یادگیری سینتکس قالببندی پیشرفتهتر مانند جدولها، نمودارها و عبارات ریاضی، به [[سینتکس قالببندی پیشرفته]] مراجعه کنید.
برای یادگیری بیشتر درباره نحوه تجزیه Markdown توسط Obsidian، به [[Markdown به سبک Obsidian]] مراجعه کنید.