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.