## อ้างอิง

GitHub Markdown Callouts

เผยแพร่มีนาคม 2026

GitHub เพิ่ม syntax สำหรับ callout หรือ alert block ใน GitHub Flavored Markdown เพื่อเน้นข้อมูลสำคัญ เช่น note, tip, warning และอื่น ๆ ShowMeMyMD เป็นหนึ่งในไม่กี่ desktop viewer ที่ render สิ่งนี้ได้

## Syntax

มี 5 ประเภทหลัก

รูปแบบคือบล็อก quote ที่ขึ้นต้นด้วยแท็กพิเศษบนบรรทัดแรก:> [!TYPE]

> [!NOTE]
> ข้อมูลที่มีประโยชน์ แม้ผู้อ่านจะอ่านแบบสแกนผ่าน

NOTE จะแสดงเป็นกล่องข้อมูลโทนน้ำเงิน ใช้กับบริบทเพิ่มเติมที่ดีต่อการอ่าน

> [!TIP]
> เคล็ดลับสั้น ๆ ที่ช่วยให้ทำงานได้ง่ายขึ้น

TIP ใช้กับคำแนะนำ เทคนิค หรือแนวทางที่ช่วยผู้อ่านได้จริง

> [!IMPORTANT]
> ข้อมูลสำคัญที่ต้องรู้ก่อนทำขั้นตอนต่อไป

IMPORTANT ใช้กับข้อมูลที่ข้ามไม่ได้

> [!WARNING]
> ข้อมูลเตือนที่ควรใส่ใจทันที

WARNING เหมาะกับสิ่งที่อาจก่อปัญหาถ้าไม่ระวัง

> [!CAUTION]
> คำเตือนเรื่องความเสี่ยงหรือผลลัพธ์ที่ย้อนกลับไม่ได้

CAUTION ใช้กับงานที่อาจทำให้ข้อมูลหายหรือเกิดความเสียหาย

## วิธีใช้

เขียนให้มีประสิทธิภาพ

ใช้เท่าที่จำเป็น

ถ้ามี callout เต็มหน้า ผู้อ่านจะเริ่มละเลย สีสันควรช่วยเน้น ไม่ใช่สร้าง noise

เลือกประเภทให้ตรงความรุนแรง

อย่าใช้ WARNING กับเรื่องเล็ก ๆ และอย่าใช้ NOTE กับสิ่งที่อาจทำให้ข้อมูลพัง

เขียนสั้น กระชับ

Callout มักเหมาะกับ 1-3 ประโยค ถ้ายาวกว่านั้นให้ย้ายไปเนื้อหาหลัก

## รองรับที่ไหน

ShowMeMyMD แสดงผล callout ได้จริง

เครื่องมือ	การรองรับ
GitHub (เว็บ)	เต็มรูปแบบ พร้อมสีและไอคอน
ShowMeMyMD	แสดงผลเต็มบนเดสก์ท็อป
VS Code บางส่วน	ขึ้นกับ extension
ตัว render ทั่วไป	มักเหลือแค่ blockquote ธรรมดา

ถ้าคุณเขียนเอกสารหรือ README ที่ใช้ callout บ่อย ๆ ShowMeMyMD ช่วยให้คุณ ดูผลลัพธ์แบบเดียวกับที่เห็นบน GitHub ได้บน Mac

Callout ที่ render ได้จริงบน Mac

ธีมพร้อมใช้งาน และไม่มีอะไรให้ตั้งค่า