HTML در فایل های Markdown

Markdown یک قالب نوشتاری است. HTML یک قالب انتشار است. بنابراین، نحو Markdown به معنای ارائه تطبیق پذیری کامل HTML نیست، بلکه فقط رایج ترین عناصر برای متن نوشته شده است. هنگامی که نیاز به انجام کارهای پیچیده‌تری دارید، می‌توانید از هر تگ HTML درون خطی و تگ‌های سطح بلوک که توسط DevSite در یک فایل Markdown پشتیبانی می‌شوند، استفاده کنید. نیازی به نشان دادن اینکه در حال تغییر از Markdown به HTML نیستید، فقط از تگ HTML مانند مثال زیر استفاده کنید.

This sentence is in Markdown with a <b>bold inline HTML tag</b>.

HTML درون خطی

تگ‌های HTML درون خطی را می‌توان در یک پاراگراف Markdown، آیتم فهرست، یا هدر استفاده کرد، و همچنین می‌تواند حاوی نحو Markdown باشد (به عنوان مثال، **strong** ، *emphasis* ، و غیره) وقتی می‌خواهید توجه را جلب کنید مفید است. کمی کد، مانند مثال زیر.

This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>

HTML سطح بلوک

برچسب‌های HTML سطح بلوک که توسط DevSite پشتیبانی می‌شوند باید با یک خط خالی از محتوای اطراف جدا شوند. و برخلاف تگ های HTML درون خطی، نحو Markdown (به عنوان مثال، **strong** ، *emphasis* ، و غیره) در تگ های HTML سطح بلوک مانند مثال زیر ارائه نمی شود.

This is a Markdown paragraph that explains Java format strings:
                                  // required blank line
<pre>
  System.out.format("The square of *%d* is *%f*.*%n*", i, r);
</pre>
                                  // required blank line
This is another Markdown paragraph.

بهترین شیوه ها

توصیه می کنیم HTML را در فایل های Markdown به روش های زیر قالب بندی کنید تا از خطاهای رندر در DevSite جلوگیری کنید.

از برچسب‌های HTML پشتیبانی‌نشده در سطح بلوک استفاده نکنید DevSite بسیاری از تگ‌های HTML سطح بلوک را پشتیبانی می‌کند. اما شامل یک مورد پشتیبانی نشده یا HTML شما را به صورت متن نمایش می دهد یا کد را می شکند.

هنگام تورفتگی برچسب‌های شروع و پایان در سطح بلوک نباید برگه‌ها یا فاصله‌های اضافی اضافه کنید. برخی از ویرایشگرها به طور خودکار برگه ها یا فضاهای اضافی اضافه می کنند - مراقب باشید!

This is a regular paragraph in Markdown.

<p>
    This is an HTML paragraph with proper indentation!
</p>

This is a regular paragraph in Markdown.

فراموش نکنید که کد بدون فرورفتگی نسبی است

به عنوان مثال، هنگام ایجاد لیست در Markdown، نیازی به تورفتگی تگ های شروع و پایان در سطح بلوک ندارید.

* This is a list item in Markdown

<p>This is an HTML paragraph with proper indentation!</p>

* This is a list item in Markdown

یک خط خالی بین تگ شروع و پایان اضافه نکنید

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

This is a regular paragraph in Markdown.

<section>
  <p>
    hello
   </p>
  <p>
    hello
  </p>
</section>

This is a regular paragraph in Markdown.