ไวยากรณ์บล็อกอ้างอิง

บล็อกอ้างอิง (Blockquote) ใช้เพื่อเน้นข้อความที่ถูกอ้างถึงหรือข้อมูลสำคัญ ใน Markdown ใช้สัญลักษณ์ > ที่ต้นบรรทัดเพื่อสร้างบล็อกอ้างอิง

ไวยากรณ์พื้นฐาน

อ้างอิงแบบบรรทัดเดียว

> นี่คือบล็อกอ้างอิง

ผลลัพธ์การเรนเดอร์:

นี่คือบล็อกอ้างอิง

อ้างอิงหลายบรรทัด

> นี่คือบรรทัดที่หนึ่งของอ้างอิง
> นี่คือบรรทัดที่สองของอ้างอิง
> นี่คือบรรทัดที่สามของอ้างอิง

ผลลัพธ์การเรนเดอร์:

นี่คือบรรทัดที่หนึ่งของอ้างอิง นี่คือบรรทัดที่สองของอ้างอิง นี่คือบรรทัดที่สามของอ้างอิง

อ้างอิงแบบย่อหน้า

ภายในอ้างอิงสามารถมีหลายย่อหน้าได้:

> นี่คือย่อหน้าแรกของอ้างอิง
>
> นี่คือย่อหน้าที่สองของอ้างอิง

ผลลัพธ์การเรนเดอร์:

นี่คือย่อหน้าแรกของอ้างอิง

นี่คือย่อหน้าที่สองของอ้างอิง

การซ้อนบล็อกอ้างอิง

ซ้อนแบบพื้นฐาน

ใช้ >> เพื่อสร้างระดับซ้อน:

> นี่คือระดับที่หนึ่ง
>
> > นี่คือระดับที่สอง
>
> กลับมาที่ระดับที่หนึ่ง

ผลลัพธ์การเรนเดอร์:

นี่คือระดับที่หนึ่ง

นี่คือระดับที่สอง

กลับมาที่ระดับที่หนึ่ง

ซ้อนหลายชั้น

> ระดับที่หนึ่ง
> > ระดับที่สอง
> > > ระดับที่สาม
> > > > ระดับที่สี่
> >
> > กลับมาที่ระดับที่สอง
>
> กลับมาที่ระดับที่หนึ่ง

ผลลัพธ์การเรนเดอร์:

ระดับที่หนึ่ง

ระดับที่สอง

ระดับที่สาม

ระดับที่สี่

กลับมาที่ระดับที่สอง

กลับมาที่ระดับที่หนึ่ง

องค์ประกอบอื่นภายในอ้างอิง

การจัดรูปแบบภายในอ้างอิง

> **ตัวหนา** และ *ตัวเอียง* ใช้งานได้ตามปกติในอ้างอิง
>
> สามารถใช้ `โค้ดในบรรทัด` และรูปแบบอื่น ๆ ได้

ผลลัพธ์การเรนเดอร์:

ตัวหนา และ ตัวเอียง ใช้งานได้ตามปกติในอ้างอิง

สามารถใช้ โค้ดในบรรทัด และรูปแบบอื่น ๆ ได้

หัวเรื่องภายในอ้างอิง

> ## หัวเรื่องภายในอ้างอิง
>
> นี่คือเนื้อหาภายในอ้างอิง
>
> ### หัวเรื่องย่อย
>
> เนื้อหาเพิ่มเติม

ผลลัพธ์การเรนเดอร์:

หัวเรื่องภายในอ้างอิง

นี่คือเนื้อหาภายในอ้างอิง

หัวเรื่องย่อย

เนื้อหาเพิ่มเติม

รายการภายในอ้างอิง

> รายการภายในอ้างอิง:
>
> 1. รายการที่หนึ่ง
> 2. รายการที่สอง
> 3. รายการที่สาม
>
> หรือรายการไม่เรียงลำดับ:
>
> - รายการ A
> - รายการ B
> - รายการ C

ผลลัพธ์การเรนเดอร์:

รายการภายในอ้างอิง:

1. รายการที่หนึ่ง
2. รายการที่สอง
3. รายการที่สาม

หรือรายการไม่เรียงลำดับ:

• รายการ A
• รายการ B
• รายการ C

โค้ดบล็อกภายในอ้างอิง

> ตัวอย่างโค้ด:
>
> ```javascript
> function hello() {
>   console.log("Hello, World!");
> }
> ```
>
> โค้ดบล็อกจะแสดงผลได้ตามปกติภายในอ้างอิง

ผลลัพธ์การเรนเดอร์:

ตัวอย่างโค้ด:

function hello() {
  console.log("Hello, World!");
}

โค้ดบล็อกจะแสดงผลได้ตามปกติภายในอ้างอิง

ลิงก์ภายในอ้างอิง

> ดูเพิ่มเติมที่ [เอกสารทางการ](https://www.markdownlang.com)
>
> หรือเข้า <https://www.markdownlang.com> ได้โดยตรง

ผลลัพธ์การเรนเดอร์:

ดูเพิ่มเติมที่ เอกสารทางการ

หรือเข้า https://www.markdownlang.com ได้โดยตรง

กรณีใช้งานทั่วไป

1. การอ้างอิงวรรณกรรม

> "Markdown เป็นภาษามาร์กอัปแบบเบาที่ช่วยให้ผู้ใช้เขียนเอกสารด้วยข้อความธรรมดาที่อ่านและเขียนได้ง่าย"
>
> —— John Gruber, ผู้สร้าง Markdown

ผลลัพธ์การเรนเดอร์:

"Markdown เป็นภาษามาร์กอัปแบบเบาที่ช่วยให้ผู้ใช้เขียนเอกสารด้วยข้อความธรรมดาที่อ่านและเขียนได้ง่าย"

—— John Gruber, ผู้สร้าง Markdown

2. ข้อความเตือน

> ⚠️ **คำเตือน**
>
> การดำเนินการนี้จะลบข้อมูลทั้งหมด โปรดสำรองไฟล์สำคัญก่อน

ผลลัพธ์การเรนเดอร์:

⚠️ คำเตือน

การดำเนินการนี้จะลบข้อมูลทั้งหมด โปรดสำรองไฟล์สำคัญก่อน

3. ข้อความแนะนำ

> 💡 **เคล็ดลับ**
>
> ใช้ปุ่มลัด `Ctrl+S` เพื่อบันทึกอย่างรวดเร็ว

ผลลัพธ์การเรนเดอร์:

💡 เคล็ดลับ

ใช้ปุ่มลัด Ctrl+S เพื่อบันทึกอย่างรวดเร็ว

4. ข้อความสำคัญ

> 📌 **สำคัญ**
>
> ก่อนเริ่มต้น โปรดตรวจสอบว่าคุณได้ติดตั้งสิ่งต่อไปนี้แล้ว:
>
> - Node.js (>= 14.0)
> - npm (>= 6.0)
> - Git

ผลลัพธ์การเรนเดอร์:

📌 สำคัญ

ก่อนเริ่มต้น โปรดตรวจสอบว่าคุณได้ติดตั้งสิ่งต่อไปนี้แล้ว:

• Node.js (>= 14.0)
• npm (>= 6.0)
• Git

ข้อผิดพลาดที่พบบ่อยและแนวทางแก้ไข

1. ลืมใส่สัญลักษณ์ >

❌ ผิด:
> บรรทัดแรกของอ้างอิง
บรรทัดที่สองลืมใส่ >  ← บรรทัดนี้จะไม่ถูกรวมในอ้างอิง

✅ ถูกต้อง:
> บรรทัดแรกของอ้างอิง
> บรรทัดที่สองของอ้างอิง

2. ระดับการซ้อนไม่ถูกต้อง

❌ ผิด:
> ระดับที่หนึ่ง
> > > ข้ามไประดับที่สาม  ← ข้ามระดับที่สอง

✅ ถูกต้อง:
> ระดับที่หนึ่ง
> > ระดับที่สอง
> > > ระดับที่สาม

3. จัดการบรรทัดว่าง

❌ อาจมีปัญหา:
> ย่อหน้าแรก

> ย่อหน้าที่สอง  ← จะเกิดอ้างอิง 2 บล็อกแยกกัน

✅ การอ้างอิงหลายย่อหน้าที่ถูกต้อง:
> ย่อหน้าแรก
>
> ย่อหน้าที่สอง

แนวปฏิบัติที่ดี

1. รักษาสไตล์ให้สม่ำเสมอ

✅ แนะนำ: ใช้สไตล์เดียวกัน
> ใช้บล็อกอ้างอิงกับข้อมูลสำคัญ
> รักษารูปแบบให้คงที่

❌ ไม่แนะนำ: ผสมหลายสไตล์
> บางครั้งใช้อ้างอิง
**บางครั้งใช้ตัวหนาแทน**

2. ใช้การซ้อนอย่างพอเหมาะ

✅ แนะนำ: เรียบง่ายและชัดเจน
> ประเด็นหลัก
> > เหตุผลสนับสนุน
>
> ต่อประเด็นหลัก

❌ ไม่แนะนำ: ซ้อนลึกเกินไป
> > > > > ลึกเกินไป ทำให้อ่านยาก

3. ใช้อย่างมีความหมาย

✅ แนะนำ: อ้างอิงที่มีเหตุผล
> นี่คือข้อมูลสำคัญจากเอกสารอ้างอิงที่เชื่อถือได้

❌ ไม่แนะนำ: ใช้เพื่อประดับ
> ข้อความทั่วไปที่ไม่ต้องการรูปแบบอ้างอิง

เอาต์พุต HTML

การแปลงอ้างอิงเป็น HTML:

> นี่คือข้อความอ้างอิง

แปลงเป็น:

<blockquote>
  <p>นี่คือข้อความอ้างอิง</p>
</blockquote>

อ้างอิงแบบซ้อน:

> ระดับที่หนึ่ง
> > ระดับที่สอง

แปลงเป็น:

<blockquote>
  <p>ระดับที่หนึ่ง</p>
  <blockquote>
    <p>ระดับที่สอง</p>
  </blockquote>
</blockquote>

สไตล์ปรับแต่งเอง

บางตัวประมวลผล Markdown รองรับสไตล์อ้างอิงแบบปรับแต่ง:

กล่องหมายเหตุสไตล์ GitHub

> [!NOTE]
> นี่คือข้อความข้อมูล

> [!WARNING]
> นี่คือข้อความคำเตือน

> [!IMPORTANT]
> นี่คือข้อความสำคัญ

ใช้ HTML และ CSS

<blockquote style="border-left: 4px solid #3498db; padding-left: 1em; color: #7f8c8d;">
นี่คือบล็อกอ้างอิงที่มีสไตล์กำหนดเอง
</blockquote>

ตัวอย่างการใช้งานจริง

ตัวอย่างในเอกสาร API

## การยืนยันตัวตนผู้ใช้

การยืนยันตัวตนเป็นขั้นตอนจำเป็นก่อนเข้าถึง API

> **วิธีการยืนยันตัวตน**
>
> API ใช้ Bearer Token ในการยืนยันตัวตน:
>
> ```bash
> curl -H "Authorization: Bearer YOUR_TOKEN" \
>      https://api.example.com/users
> ```

### ตัวอย่างคำขอ

ส่งคำขอ POST เพื่อสร้างผู้ใช้:

> ```json
> {
>   "name": "Zhang San",
>   "email": "zhangsan@example.com",
>   "role": "user"
> }
> ```

ข้อควรระวังในบทเรียน

## ขั้นตอนการติดตั้ง

1. ดาวน์โหลดตัวติดตั้ง
2. รันโปรแกรมติดตั้ง

> ⚠️ **ข้อควรระวัง**
>
> ก่อนติดตั้ง โปรดตรวจสอบว่า:
> - ปิดโปรแกรมป้องกันไวรัส
> - รันด้วยสิทธิ์ผู้ดูแลระบบ
> - มีพื้นที่ดิสก์อย่างน้อย 2GB

3. ทำตามวิซาร์ดจนเสร็จสิ้น

ไวยากรณ์ที่เกี่ยวข้อง

• ไวยากรณ์การเน้น - การจัดรูปแบบข้อความ
• ไวยากรณ์รายการ - รายการหัวข้อ
• ไวยากรณ์โค้ด - การจัดรูปแบบโค้ด
• ไวยากรณ์ลิงก์ - การสร้างลิงก์

แบบฝึกหัด

ลองสร้างสิ่งต่อไปนี้:

1. บล็อกอ้างอิงที่มีหลายย่อหน้า
2. โครงสร้างอ้างอิงแบบสามระดับ
3. อ้างอิงสำหรับคำอธิบายเชิงเทคนิคที่มีโค้ดตัวอย่าง
4. บทสนทนาแบบซ้อนในอ้างอิง