مارک‌داون

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

مثال‌های مارک‌داون

ظاهر طراحی دادن به متن

بلوک نقل‌قول

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

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

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

[^1]: نقل‌قول بالا گزیده‌ای از [سخنرانی](https://www.youtube.com/watch?v=PAAkCSZUG1c) راب پایک در Gopherfest، در تاریخ ۲۷ آبان ۱۳۹۴ است.

جدول‌ها

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

|     نام | سن  |
|--------|------|
|    گودرز |  ۳۰|
|  آصف |    ۳۴  |

مارک‌داون درون‌خطی درون جدول‌ها

| کج   | توپر     | کد   |
| --------  | -------- | ------ |
| *کج* | **توپر** | `کد` |

بلوک‌های کد

فهرست‌ها

فهرست مرتب‌شده

1. اولین آیتم
2. دومین آیتم
3. سومین آیتم

1. اولین آیتم
2. دومین آیتم
3. سومین آیتم

فهرست مرتب‌نشده

• فهرست آیتم
• یک آیتم دیگه
• و یک آیتم دیگه

* فهرست آیتم
* یک آیتم دیگه
* و یک آیتم دیگه

فهرست تو در تو

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

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

عکس‌ها

![landscape](https://source.unsplash.com/featured/800x600?landscape)

با توضیحات:

![landscape](https://source.unsplash.com/featured/800x600?landscape "یک چشم‌انداز Unsplash")

پیکربندی

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

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

برای گزینه‌های پیکربندی بیشتر، به مستندات Hugo در پیکربندی نشانه‌گذاری مراجعه کنید.

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

• راهنمای مارک‌داون
• برگه تقلب مارک‌داون
• آموزش مارک‌داون
• مرجع مارک‌داون