راهنمای نوشتن و ساختارهای نوشتار در هاب ارزدیجیتال

در هاب ارزدیجیتال، نوشته‌ها با فرمت ساده‌ (متن خام) می‌توانند کافی باشند، اما برای کسانی که می‌خواهند نوشته‌های خود را با استفاده از قابلیت‌های اضافی بهبود ببخشند، ادیتور از فرمت‌های Markdown، BBCode و HTML پشتیبانی می‌کند. در این راهنما با انواع فرمت‌های پشتیبانی‌شده و نحوه استفاده موثر از آن‌ها آشنا خواهید شد.

مارک‌داون (Markdown) چیست؟

مارک‌داون (Markdown) یک زبان ساده برای فرمت‌دهی متن است که به شما اجازه می‌دهد بدون نیاز به دانش فنی خاص، متن‌های خود را برجسته، لینک‌دار، کدگذاری و مرتب کنید. تنها کافی است از چند علامت ساده مانند ستاره، براکت یا بک‌تیک استفاده کنید. مارک‌داون به دلیل سادگی و قابلیت خوانایی بالا، ابزار اصلی فرمت‌دهی در هاب ارزدیجیتال محسوب می‌شود.

ساختارها

هاب ارزدیجیتال از markdown-it 490 برای اجرای Markdown استفاده می‌کند. از قابلیت‌های رایج Markdown می‌توان به موارد زیر اشاره کرد:

  • بولد کردن متن: **متن** - مثال: متن
  • ایتالیک کردن متن: *متن* - مثال: متن
  • لینک: [عنوان](https://example.com) - مثال: لینک
  • کد داخلی: `کد`
  • برجسته کردن: <mark>متن</mark> - مثال: متن
  • بلوک کد: استفاده از “```” در خط اول و خط آخر کد:

مثال:

بلوک کد

در نوشته‌های طولانی‌تر، استفاده از ساختاردهی با تیترها مفید است:

## تیتر 2
### تیتر 3
#### تیتر 4

مثال از تیتر 2

مثال از تیتر 3

مثال از تیتر 4

نکته: در صورت بارگذاری تصویر، ساختار Markdown به صورت خودکار برای ارجاع به تصویر تولید می‌شود.

تگ‌های BBCode پشتیبانی‌شده

هاب ارزدیجیتال از مجموعه‌ای از تگ‌های رایج BBCode پشتیبانی می‌کند که برخی از آن‌ها به‌طور خودکار برای قالب‌بندی خاص ایجاد می‌شوند، مثلاً هنگام نقل قول یک نوشته:

[quote="کاربر"]متن نقل‌شده[/quote]

برای مخفی کردن متن به‌عنوان اسپویلر یا جزئیات، می‌توانید از تگ‌های زیر استفاده کنید:

[spoiler]متن اسپویل‌شده[/spoiler]
[details="برای دیدن کلیک کنید"]متن مخفی[/details]

تگ‌های BBCode برای قالب‌بندی ساده که توسط Markdown نیز پشتیبانی می‌شوند:

  • [b]متن بولد[/b]
  • [i]متن مورب[/i]
  • [u]متن زیرخط‌دار[/u]
  • [s]متن خط‌خورده[/s]
  • [ul][li]گزینه اول[/li][/ul]
  • [url]http://example.com[/url]
  • [code]کد[/code]

تگ‌های HTML پشتیبانی‌شده

برای امنیت و یکپارچگی، هاب ارزدیجیتال از یک زیرمجموعه امن از HTML پشتیبانی می‌کند. شما می‌توانید HTML را با Markdown ترکیب کنید، اما تنها تگ‌های خاصی مجاز هستند.

تعدادی از تگ‌های HTML مجاز عبارتند از:

  • لینک: <a href="https://example.com">لینک</a>
  • متن بولد: <strong>متن بولد</strong>
  • متن مورب: <em>متن مورب</em>
  • لیست: <ul><li>آیتم لیست</li></ul>
  • تصویر: <img src="https://example.com/image.png" alt="توضیحات">

:information_source: توجه: استایل‌های داخلی مانند <span style="color:red">متن رنگی</span> پشتیبانی نمی‌شوند.

مشکلات رایج و راه‌حل‌ها

  • تگ‌های BBCode یا HTML کار نمی‌کنند: مطمئن شوید که از تگ‌های پشتیبانی‌شده استفاده می‌کنید.
  • استایل‌های داخلی حذف می‌شوند: برای امنیت، هاب ارزدیجیتال از استایل‌های داخلی پشتیبانی نمی‌کند.
  • تغییرات قالب‌بندی هنگام کپی کردن از سایر ادیتورها: برخی از فرمت‌های غنی ممکن است به‌درستی نمایش داده نشوند؛ برای قالب‌بندی منسجم از Markdown استفاده کنید.
1 لایک