7.0 KiB
title, weight
| title | weight |
|---|---|
| Markdown | 2 |
Hugo از Markdown برای قالب‌بندی متن، ایجاد لیست‌ها و موارد دیگر پشتیبانی می‌کند. این صفحه برخی از رایج‌ترین نمونه‌های نحوه استفاده از Markdown را به شما نشان می‌دهد.
نمونه‌های Markdown
استایل‌دهی متن
| استایل | نحو | مثال | خروجی |
|---|---|---|---|
| پررنگ | **متن پررنگ** |
**متن پررنگ** |
متن پررنگ |
| مورب | *متن مورب* |
*متن مورب* |
متن مورب |
| خط‌خورده | ~~متن خط‌خورده~~ |
~~متن خط‌خورده~~ |
|
| زیرنویس | <sub></sub> |
این یک <sub>زیرنویس</sub> است |
این یک زیرنویس است |
| بالانویس | <sup></sup> |
این یک <sup>بالانویس</sup> است |
این یک بالانویس است |
نقل‌قول‌ها
نقل‌قول با ذکر منبع
با اشتراک‌گذاری حافظه ارتباط برقرار نکنید، بلکه با ارتباط، حافظه را اشتراک بگذارید.
— Rob Pike1
> با اشتراک‌گذاری حافظه ارتباط برقرار نکنید، بلکه با ارتباط، حافظه را اشتراک بگذارید.<br>
> — <cite>Rob Pike[^1]</cite>
[^1]: این نقل‌قول از [سخنرانی](https://www.youtube.com/watch?v=PAAkCSZUG1c) Rob Pike در Gopherfest در ۱۸ نوامبر ۲۰۱۵ گرفته شده است.
هشدارها
{{< new-feature version="v0.9.0" >}}
هشدارها یک افزونه Markdown بر اساس نحو نقل‌قول هستند که می‌توانید برای تأکید بر اطلاعات مهم از آن‌ها استفاده کنید. هشدارهای به سبک GitHub پشتیبانی می‌شوند. لطفاً مطمئن شوید که از آخرین نسخه Hextra و Hugo v0.146.0 یا بالاتر استفاده می‌کنید.
Note
اطلاعات مفیدی که کاربران باید بدانند، حتی هنگام مرور سریع محتوا.
Tip
توصیه‌های مفید برای انجام بهتر یا آسان‌تر کارها.
Important
اطلاعات کلیدی که کاربران برای رسیدن به هدف خود نیاز دارند.
Warning
اطلاعات فوری که نیاز به توجه فوری کاربر دارد تا از مشکلات جلوگیری شود.
Caution
هشدار درباره خطرات یا نتایج منفی برخی اقدامات.
> [!NOTE]
> اطلاعات مفیدی که کاربران باید بدانند، حتی هنگام مرور سریع محتوا.
> [!TIP]
> توصیه‌های مفید برای انجام بهتر یا آسان‌تر کارها.
> [!IMPORTANT]
> اطلاعات کلیدی که کاربران برای رسیدن به هدف خود نیاز دارند.
> [!WARNING]
> اطلاعات فوری که نیاز به توجه فوری کاربر دارد تا از مشکلات جلوگیری شود.
> [!CAUTION]
> هشدار درباره خطرات یا نتایج منفی برخی اقدامات.
جداول
جداول بخشی از مشخصه اصلی Markdown نیستند، اما Hugo به صورت پیش‌فرض از آن‌ها پشتیبانی می‌کند.
| نام | سن |
|---|---|
| باب | ۲۷ |
| آلیس | ۲۳ |
| نام | سن |
| :---- | :-- |
| باب | ۲۷ |
| آلیس | ۲۳ |
Markdown درون‌خطی در جداول
| مورب | پررنگ | کد |
|---|---|---|
| مورب | پررنگ | کد |
| مورب | پررنگ | کد |
| :-------- | :------- | :----- |
| _مورب_ | **پررنگ** | `کد` |
بلوک‌های کد
{{< cards >}} {{< card link="../../guide/syntax-highlighting" title="رنگ‌آمیزی نحوی" icon="sparkles" >}} {{< /cards >}}
لیست‌ها
لیست مرتب
۱. مورد اول ۲. مورد دوم ۳. مورد سوم
۱. مورد اول
۲. مورد دوم
۳. مورد سوم
لیست نامرتب
- مورد لیست
- مورد دیگر
- و یک مورد دیگر
* مورد لیست
* مورد دیگر
* و یک مورد دیگر
لیست تو در تو
- میوه
- سیب
- پرتقال
- موز
- لبنیات
- شیر
- پنیر
- میوه
- سیب
- پرتقال
- موز
- لبنیات
- شیر
- پنیر
تصاویر
با عنوان:
برای عملکرد پیشرفته‌تر، از shortcode Figure داخلی Hugo استفاده کنید.
پیکربندی
Hugo از Goldmark برای تجزیه Markdown استفاده می‌کند.
رندر Markdown را می‌توان در hugo.yaml تحت markup.goldmark پیکربندی کرد.
در زیر پیکربندی پیش‌فرض Hextra آمده است:
markup:
goldmark:
renderer:
unsafe: true
highlight:
noClasses: false
برای گزینه‌های پیکربندی بیشتر، مستندات Hugo در مورد پیکربندی Markup را ببینید.