Markdown

Hugo از Markdown برای قالب‌بندی متن، ایجاد لیست‌ها و موارد دیگر پشتیبانی می‌کند. این صفحه برخی از رایج‌ترین نمونه‌های نحوه استفاده از Markdown را به شما نشان می‌دهد.

نمونه‌های Markdown

استایل‌دهی متن

نقل‌قول‌ها

نقل‌قول با ذکر منبع

با اشتراک‌گذاری حافظه ارتباط برقرار نکنید، بلکه با ارتباط، حافظه را اشتراک بگذارید.
— Rob Pike¹

> با اشتراک‌گذاری حافظه ارتباط برقرار نکنید، بلکه با ارتباط، حافظه را اشتراک بگذارید.<br>
> — <cite>Rob Pike[^1]</cite>

[^1]: این نقل‌قول از [سخنرانی](https://www.youtube.com/watch?v=PAAkCSZUG1c) Rob Pike در Gopherfest در ۱۸ نوامبر ۲۰۱۵ گرفته شده است.

هشدارها

هشدارها یک افزونه Markdown بر اساس نحو نقل‌قول هستند که می‌توانید برای تأکید بر اطلاعات مهم از آن‌ها استفاده کنید. هشدارهای به سبک GitHub پشتیبانی می‌شوند. لطفاً مطمئن شوید که از آخرین نسخه Hextra و Hugo v0.146.0 یا بالاتر استفاده می‌کنید.

> [!NOTE]
> اطلاعات مفیدی که کاربران باید بدانند، حتی هنگام مرور سریع محتوا.

> [!TIP]
> توصیه‌های مفید برای انجام بهتر یا آسان‌تر کارها.

> [!IMPORTANT]
> اطلاعات کلیدی که کاربران برای رسیدن به هدف خود نیاز دارند.

> [!WARNING]
> اطلاعات فوری که نیاز به توجه فوری کاربر دارد تا از مشکلات جلوگیری شود.

> [!CAUTION]
> هشدار درباره خطرات یا نتایج منفی برخی اقدامات.

جداول

جداول بخشی از مشخصه اصلی Markdown نیستند، اما Hugo به صورت پیش‌فرض از آن‌ها پشتیبانی می‌کند.

| نام  | سن |
| :---- | :-- |
| باب   | ۲۷  |
| آلیس | ۲۳  |

Markdown درون‌خطی در جداول

| مورب   | پررنگ     | کد   |
| :-------- | :------- | :----- |
| _مورب_ | **پررنگ** | `کد` |

بلوک‌های کد

لیست‌ها

لیست مرتب

۱. مورد اول ۲. مورد دوم ۳. مورد سوم

۱. مورد اول
۲. مورد دوم
۳. مورد سوم

لیست نامرتب

• مورد لیست
• مورد دیگر
• و یک مورد دیگر

* مورد لیست
* مورد دیگر
* و یک مورد دیگر

لیست تو در تو

• میوه
  • سیب
  • پرتقال
  • موز
• لبنیات
  • شیر
  • پنیر

- میوه
  - سیب
  - پرتقال
  - موز
- لبنیات
  - شیر
  - پنیر

لیست وظایف

• نوشتن مستندات
• بازبینی کد
• استقرار تغییرات

- [x] نوشتن مستندات
- [ ] بازبینی کد
- [ ] استقرار تغییرات

تصاویر

![منظره](https://picsum.photos/800/600)

با عنوان:

![منظره](https://picsum.photos/800/600 "Lorem Picsum")

برای عملکرد پیشرفته‌تر، از shortcode Figure داخلی Hugo استفاده کنید.

پیکربندی

Hugo از Goldmark برای تجزیه Markdown استفاده می‌کند. رندر Markdown را می‌توان در hugo.yaml تحت markup.goldmark پیکربندی کرد. در زیر پیکربندی پیش‌فرض Hextra آمده است:

markup:
  goldmark:
    renderer:
      unsafe: true
  highlight:
    noClasses: false

برای گزینه‌های پیکربندی بیشتر، مستندات Hugo در مورد پیکربندی Markup را ببینید.

منابع یادگیری

• راهنمای Markdown
• راهنمای سریع Markdown
• آموزش Markdown
• مرجع Markdown