ไวยากรณ์การเน้น
ไวยากรณ์การเน้นใช้เพื่อเน้นข้อความให้เด่นชัด เป็นหนึ่งในฟังก์ชันการจัดรูปแบบที่ใช้บ่อยที่สุดใน Markdown ผ่านวิธีเน้นที่แตกต่างกัน สามารถทำให้เนื้อหาที่สำคัญเด่นชัดขึ้นได้
ไวยากรณ์การเน้นพื้นฐาน
ตัวเอียง (Italic)
ใช้เครื่องหมายดอกจัน * หรือขีดล่าง _ ล้อมรอบข้อความ:
*ข้อความตัวเอียง*
_ข้อความตัวเอียง_ผลการแสดง: ข้อความตัวเอียงข้อความตัวเอียง
ตัวหนา (Bold)
ใช้เครื่องหมายดอกจันคู่ ** หรือขีดล่างคู่ __ ล้อมรอบข้อความ:
**ข้อความตัวหนา**
__ข้อความตัวหนา__ผลการแสดง: ข้อความตัวหนาข้อความตัวหนา
ตัวหนาเอียง (Bold and Italic)
ใช้เครื่องหมายดอกจันสามตัว *** หรือขีดล่างสามตัว ___ หรือใช้ผสมกัน:
***ข้อความตัวหนาเอียง***
___ข้อความตัวหนาเอียง___
**_ข้อความตัวหนาเอียง_**
*__ข้อความตัวหนาเอียง__*ผลการแสดง: ข้อความตัวหนาเอียงข้อความตัวหนาเอียงข้อความตัวหนาเอียงข้อความตัวหนาเอียง
ข้อเสนอแนะเกี่ยวกับไวยากรณ์
เครื่องหมายดอกจัน vs ขีดล่าง
| สัญลักษณ์ | ข้อดี | ข้อเสีย | สถานการณ์ที่แนะนำ |
|---|---|---|---|
* | ใช้บ่อยกว่า, เข้ากันได้ดี | ในบางตัวแก้ไขอาจสับสนกับรายการ | แนะนำทั่วไป |
_ | ภายในคำชัดเจนกว่า | ใช้น้อย, อาจไม่คุ้นเคย | กรณีพิเศษ |
การใช้ที่แนะนำ
✅ แนะนำ: รักษาความสอดคล้อง
ที่นี่มีข้อความ **ตัวหนา** และ *ตัวเอียง*
❌ ไม่แนะนำ: ใช้ผสมกัน
ที่นี่มีข้อความ **ตัวหนา** และ _ตัวเอียง_การใช้การเน้นภายในคำ
ข้อจำกัดของเครื่องหมายดอกจัน
เครื่องหมายดอกจันภายในคำอาจไม่ถูกระบุ:
love*is*beautiful ← อาจไม่แสดงผลเป็นตัวเอียงข้อดีของขีดล่าง
ขีดล่างภายในคำเชื่อถือได้กว่า:
love_is_beautiful ← ง่ายต่อการแสดงผลอย่างถูกต้องข้อเสนอแนะ: หากจำเป็นต้องใช้การเน้นภายในคำ ควรพิจารณาขีดล่างก่อน
การเน้นซ้อนกัน
การซ้อนพื้นฐาน
สามารถซ้อนตัวเอียงภายในตัวหนา หรือตัวหนาภายในตัวเอียง:
**นี่คือตัวหนา ประกอบด้วย *ตัวเอียง* ข้อความ**
*นี่คือตัวเอียง ประกอบด้วย **ตัวหนา** ข้อความ*ผลการแสดง: นี่คือตัวหนา ประกอบด้วย ตัวเอียง ข้อความนี่คือตัวเอียง ประกอบด้วย ตัวหนา ข้อความ
การซ้อนที่ซับซ้อน
***นี่คือตัวหนาเอียง ประกอบด้วย ข้อความปกติ***
**ย่อหน้าตัวหนา ประกอบด้วย *ย่อยตัวเอียง* และข้อความปกติ**
*ย่อหน้าตัวเอียง ประกอบด้วย **คำสำคัญตัวหนา** และข้อความปกติ*ผลการแสดง: นี่คือตัวหนาเอียง ประกอบด้วย ข้อความปกติย่อหน้าตัวหนา ประกอบด้วย ย่อยตัวเอียง และข้อความปกติย่อหน้าตัวเอียง ประกอบด้วย คำสำคัญตัวหนา และข้อความปกติ
ข้อผิดพลาดทั่วไปและวิธีแก้ไข
1. สัญลักษณ์ไม่ตรงกัน
❌ ผิด:
*นี่คือตัวเอียงที่ยังไม่ปิด
**นี่คือตัวหนาที่ไม่ตรงกัน*
✅ ถูกต้อง:
*นี่คือตัวเอียงที่ถูกต้อง*
**นี่คือตัวหนาที่ถูกต้อง**2. ปัญหาช่องว่าง
❌ ผิด:
* นี่ไม่ใช่ตัวเอียง *
** นี่ไม่ใช่ตัวหนา **
✅ ถูกต้อง:
*นี่คือตัวเอียง*
**นี่คือตัวหนา**3. อักขระรอบสัญลักษณ์
❌ อาจมีปัญหา:
ข้อความ*ตัวเอียง*ข้อความ ← อาจไม่แสดงผล
✅ ปลอดภัยกว่า:
ข้อความ *ตัวเอียง* ข้อความ
ข้อความ_ตัวเอียง_ข้อความการจัดการกรณีพิเศษ
การหลีกเลี่ยงสัญลักษณ์การเน้น
หากจำเป็นต้องแสดงเครื่องหมายดอกจันหรือขีดล่างเอง ใช้แบ็กสแลชเพื่อหลีกเลี่ยง:
\*นี่ไม่ใช่ตัวเอียง\*
\**นี่ไม่ใช่ตัวหนา\**
\_นี่ไม่ใช่ตัวเอียง\_ผลการแสดง: *นี่ไม่ใช่ตัวเอียง* *นี่ไม่ใช่ตัวหนา* _นี่ไม่ใช่ตัวเอียง_
การใช้ในโค้ด
ในโค้ดแบบอินไลน์ สัญลักษณ์การเน้นจะแสดงตามตัวอักษร:
`*เครื่องหมายดอกจันที่นี่จะไม่ถูกตีความเป็นตัวเอียง*`
`**เครื่องหมายดอกจันคู่ที่นี่จะไม่ถูกตีความเป็นตัวหนา**`ผลการแสดง: *เครื่องหมายดอกจันที่นี่จะไม่ถูกตีความเป็นตัวเอียง***เครื่องหมายดอกจันคู่ที่นี่จะไม่ถูกตีความเป็นตัวหนา**
การใช้แบบมีความหมาย
การใช้งานตัวเอียงแบบมีความหมาย
- การเน้น: นี่สำคัญ
- ภาษาต่างประเทศ: Hello World
- ศัพท์เทคนิค: โปรโตคอล HTTP
- การอ้างอิง: ตามที่ "สามก๊ก" ระบุ
- ตัวแปร: ตั้งค่า x เป็น 10
การใช้งานตัวหนาแบบมีความหมาย
- ความสำคัญ: ระวังความปลอดภัย
- คำสำคัญ: อินเทอร์เฟซ API
- คำเตือน: อย่าลบไฟล์สำคัญ
- หัวข้อย่อย: ขั้นตอนแรก: ติดตั้งซอฟต์แวร์
การใช้งานตัวหนาเอียง
- สำคัญอย่างยิ่ง: อย่าทำอย่างนั้น
- แนะนำอย่างยิ่ง: แนะนำอย่างยิ่ง อ่านเอกสาร
แนวทางปฏิบัติที่ดีที่สุด
1. ใช้อย่างพอเหมาะ
✅ แนะนำ: เน้นอย่างพอเหมาะ
ฟังก์ชันนี้**สำคัญ** โปรดอ่านเอกสารที่เกี่ยวข้องอย่างระมัดระวัง
❌ ไม่แนะนำ: เน้นมากเกินไป
ฟังก์ชันนี้**สำคัญ*****มาก*** **โปรดอ่าน** **เอกสารที่เกี่ยวข้อง** **อย่างระมัดระวัง**2. รักษาความสอดคล้อง
✅ แนะนำ: ใช้เครื่องหมายดอกจันแบบสม่ำเสมอ
ใช้ **ตัวหนา** และ *ตัวเอียง* เพื่อเน้นเนื้อหา
❌ ไม่แนะนำ: ใช้สัญลักษณ์ผสมกัน
ใช้ **ตัวหนา** และ _ตัวเอียง_ เพื่อเน้นเนื้อหา3. การใช้แบบมีความหมาย
✅ แนะนำ: การเน้นที่มีความหมาย
ฟังก์ชันส่งคืน **true** หมายถึงความสำเร็จ ส่งคืน **false** หมายถึงความล้มเหลว
❌ ไม่แนะนำ: การเน้นเพื่อการตกแต่ง
ฟังก์ชัน**ส่งคืน** true **หมายถึง** ความสำเร็จ **ส่งคืน** false **หมายถึง** ความล้มเหลวHTML เอาต์พุต
ไวยากรณ์การเน้น Markdown แปลงเป็น HTML:
*ตัวเอียง* → <em>ตัวเอียง</em>
**ตัวหนา** → <strong>ตัวหนา</strong>
***ตัวหนาเอียง*** → <strong><em>ตัวหนาเอียง</em></strong>ไวยากรณ์ขยาย
โปรเซสเซอร์ Markdown บางตัวรองรับวิธีเน้นเพิ่มเติม:
ขีดฆ่า
~~ข้อความที่ถูกลบ~~ผลการแสดง: ข้อความที่ถูกลบ
ขีดเส้นใต้
<u>ข้อความขีดเส้นใต้</u>ผลการแสดง: ข้อความขีดเส้นใต้
ไฮไลต์
==ข้อความไฮไลต์== (โปรเซสเซอร์บางตัวรองรับ)
<mark>ข้อความไฮไลต์</mark> (แท็ก HTML)ตัวอย่างการใช้งานจริง
เอกสารเทคนิค
**จุดสิ้นสุด API**: `/api/users`
**เมธอด**: *GET*
**พารามิเตอร์**:
- *id* (***จำเป็น***): ID ผู้ใช้
- *format* (ไม่บังคับ): รูปแบบการส่งคืน
**ส่งคืน**: ข้อมูลผู้ใช้หรือ **ข้อความผิดพลาด**คู่มือผู้ใช้
## ขั้นตอนการติดตั้ง
**ขั้นตอนแรก**: ดาวน์โหลดแพ็คเกจติดตั้ง
เยี่ยมชมหน้าดาวน์โหลดเว็บไซต์อย่างเป็นทางการ เลือกเวอร์ชันที่เหมาะกับระบบปฏิบัติการของคุณ *โปรดแน่ใจว่าได้ดาวน์โหลดเวอร์ชันล่าสุด*
**ขั้นตอนที่สอง**: รันโปรแกรมติดตั้ง
ดับเบิลคลิกไฟล์ที่ดาวน์โหลด ทำตามตัวช่วยสร้างเพื่อติดตั้ง ***สำคัญ***: ปิดซอฟต์แวร์ป้องกันไวรัสระหว่างการติดตั้ง
**ขั้นตอนที่สาม**: ตรวจสอบการติดตั้ง
เปิดบรรทัดคำสั่ง พิมพ์ `app --version` เพื่อตรวจสอบว่าติดตั้งสำเร็จหรือไม่ไวยากรณ์ที่เกี่ยวข้อง
- ไวยากรณ์ลิงก์ - สร้างไฮเปอร์ลิงก์
- ไวยากรณ์โค้ด - การจัดรูปแบบโค้ด
- ไวยากรณ์อ้างอิง - อ้างอิงข้อความ
- ขีดฆ่า - วิธีเน้นที่ขยาย
แบบฝึกหัด
ลองสร้างเอกสารที่มีเนื้อหาดังนี้:
- คำอธิบายผลิตภัณฑ์หนึ่งรายการ ใช้ตัวหนาเพื่อเน้นคุณสมบัติสำคัญ
- คำอธิบายทางเทคนิคหนึ่งส่วน ใช้ตัวเอียงเพื่ออธิบายศัพท์เทคนิค
- ข้อความเตือนหนึ่งข้อความ ใช้ตัวหนาเอียงเพื่อเน้นความสำคัญ
- ประโยครวมหนึ่งประโยค ใช้วิธีเน้นต่างๆ ผสมกัน