HTML ในไฟล์ Markdown

Markdown เป็นรูปแบบการเขียน HTML คือรูปแบบการเผยแพร่ ดังนั้น ไวยากรณ์มาร์กดาวน์จึงไม่ได้มีไว้เพื่อนำเสนอความสามารถที่หลากหลายของ HTML แต่เป็นองค์ประกอบที่พบบ่อยที่สุดสำหรับข้อความที่เขียน เมื่อต้องการดำเนินการที่ซับซ้อนมากขึ้น คุณสามารถใช้แท็ก HTML ในบรรทัดและแท็กระดับบล็อกที่ DevSite รองรับในไฟล์ Markdown คุณไม่จำเป็นต้องระบุว่าคุณเปลี่ยนจากมาร์กดาวน์เป็น HTML เพียงใช้แท็ก HTML ตามตัวอย่างด้านล่าง

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

HTML ในบรรทัด

แท็ก HTML ในบรรทัดสามารถใช้ภายในย่อหน้ามาร์กดาวน์ รายการในรายการ หรือส่วนหัว และแท็กเหล่านี้ยังมีไวยากรณ์มาร์กดาวน์ (เช่น **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 ในไฟล์มาร์กดาวน์ด้วยวิธีต่อไปนี้เพื่อป้องกันการแสดงข้อผิดพลาดใน 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

อย่าเพิ่มบรรทัดว่างระหว่างแท็กเริ่มต้นและแท็กสิ้นสุด

ซึ่งสามารถทำได้ง่ายๆ เมื่อคุณสลับระหว่างมาร์กดาวน์กับ HTML แต่บรรทัดว่างง่ายๆ อาจทำให้หน้าเว็บแสดงอย่างไม่ถูกต้องได้อย่างง่ายดาย

This is a regular paragraph in Markdown.

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

This is a regular paragraph in Markdown.