ไวยากรณ์รายการ
รายการเป็นวิธีสำคัญในการจัดระเบียบข้อมูล Markdown รองรับรายการแบบมีลำดับและรายการแบบไม่มีลำดับ และยังสามารถสร้างรายการซ้อนและรายการงานได้
รายการแบบไม่มีลำดับ
ไวยากรณ์พื้นฐาน
ใช้ -, * หรือ + สร้างรายการแบบไม่มีลำดับ:
- รายการ 1
- รายการ 2
- รายการ 3
* รายการ 1
* รายการ 2
* รายการ 3
+ รายการ 1
+ รายการ 2
+ รายการ 3ผลการแสดง:
- รายการ 1
- รายการ 2
- รายการ 3
ข้อเสนอแนะในการเลือกสัญลักษณ์
| สัญลักษณ์ | ลักษณะ | สถานการณ์ที่แนะนำ |
|---|---|---|
- | ใช้บ่อยที่สุด เรียบง่าย | แนะนำทั่วไป |
* | สอดคล้องกับไวยากรณ์การเน้น | รักษาเอกลักษณ์สไตล์ |
+ | ใช้น้อย | ความต้องการแยกพิเศษ |
ข้อเสนอแนะ: รักษาความสอดคล้องของสัญลักษณ์ตลอดทั้งเอกสาร
รายการแบบมีลำดับ
ไวยากรณ์พื้นฐาน
ใช้ตัวเลขตามด้วยจุดสร้างรายการแบบมีลำดับ:
1. รายการแรก
2. รายการที่สอง
3. รายการที่สามผลการแสดง:
- รายการแรก
- รายการที่สอง
- รายการที่สาม
หมายเลขลำดับ
ค่าจริงของตัวเลขไม่สำคัญ Markdown จะสร้างหมายเลขลำดับที่ถูกต้องโดยอัตโนมัติ:
1. รายการแรก
3. รายการที่สอง
8. รายการที่สามผลการแสดง:
- รายการแรก
- รายการที่สอง
- รายการที่สาม
หมายเลขเริ่มต้น
สามารถระบุหมายเลขเริ่มต้น:
3. รายการที่สาม
4. รายการที่สี่
5. รายการที่ห้าผลการแสดง:
- รายการที่สาม
- รายการที่สี่
- รายการที่ห้า
รายการซ้อน
การซ้อนพื้นฐาน
ใช้การเยื้อง (2-4 ช่องว่าง) สร้างรายการซ้อน:
- รายการระดับ 1
- รายการระดับ 2-1
- รายการระดับ 2-2
- รายการระดับ 1-2
- รายการระดับ 2-1
- รายการระดับ 3-1.1
- รายการระดับ 3-1.2
- รายการระดับ 2-2ผลการแสดง:
- รายการระดับ 1
- รายการระดับ 2-1
- รายการระดับ 2-2
- รายการระดับ 1-2
- รายการระดับ 2-1
- รายการระดับ 3-1.1
- รายการระดับ 3-1.2
- รายการระดับ 2-2
- รายการระดับ 2-1
การซ้อนแบบผสม
รายการแบบมีลำดับและรายการแบบไม่มีลำดับสามารถซ้อนกันได้:
1. รายการแบบมีลำดับ 1
- รายการย่อยแบบไม่มีลำดับ 1.1
- รายการย่อยแบบไม่มีลำดับ 1.2
2. รายการแบบมีลำดับ 2
1. รายการย่อยแบบมีลำดับ 2.1
2. รายการย่อยแบบมีลำดับ 2.2
- รายการหลานแบบไม่มีลำดับ 2.2.1
- รายการหลานแบบไม่มีลำดับ 2.2.2ผลการแสดง:
- รายการแบบมีลำดับ 1
- รายการย่อยแบบไม่มีลำดับ 1.1
- รายการย่อยแบบไม่มีลำดับ 1.2
- รายการแบบมีลำดับ 2
- รายการย่อยแบบมีลำดับ 2.1
- รายการย่อยแบบมีลำดับ 2.2
- รายการหลานแบบไม่มีลำดับ 2.2.1
- รายการหลานแบบไม่มีลำดับ 2.2.2
เนื้อหาหลายย่อหน้าในรายการ
การต่อย่อหน้า
รวมหลายย่อหน้าในรายการ:
1. รายการแรก
นี่คือย่อหน้าที่สองของรายการแรก ต้องเยื้องเพื่อคงอยู่ในรายการ
2. รายการที่สอง
นี่คือย่อหน้าที่สองของรายการที่สอง
นี่คือย่อหน้าที่สามของรายการที่สอง
3. รายการที่สามผลการแสดง:
รายการแรก
นี่คือย่อหน้าที่สองของรายการแรก ต้องเยื้องเพื่อคงอยู่ในรายการ
รายการที่สอง
นี่คือย่อหน้าที่สองของรายการที่สอง
นี่คือย่อหน้าที่สามของรายการที่สอง
รายการที่สาม
บล็อกโค้ด
รวมบล็อกโค้ดในรายการ:
1. ติดตั้งการพึ่งพา
```bash
npm install expressสร้างเซิร์ฟเวอร์
javascriptconst express = require('express'); const app = express();เริ่มต้นเซิร์ฟเวอร์
### บล็อกอ้างอิง
รวมอ้างอิงในรายการ:
```markdown
1. การเตรียมการ
> ตรวจสอบว่าคุณมีพื้นที่ดิสก์เพียงพอ
> แนะนำให้สำรองพื้นที่อย่างน้อย 10GB
2. เริ่มติดตั้งรายการงาน
ไวยากรณ์พื้นฐาน
ใช้ - [ ] สร้างงานที่ยังไม่เสร็จ - [x] สร้างงานที่เสร็จแล้ว:
- [x] งานที่เสร็จแล้ว
- [ ] งานที่ยังไม่เสร็จ
- [x] งานที่เสร็จอีกงานหนึ่ง
- [ ] สิ่งที่ต้องทำผลการแสดง:
- [x] งานที่เสร็จแล้ว
- [ ] งานที่ยังไม่เสร็จ
- [x] งานที่เสร็จอีกงานหนึ่ง
- [ ] สิ่งที่ต้องทำ
รายการงานซ้อน
- [x] การวางแผนโปรเจ็กต์
- [x] การวิเคราะห์ความต้องการ
- [x] การวิจัยเทคนิค
- [ ] การออกแบบต้นแบบ
- [ ] ขั้นตอนการพัฒนา
- [ ] การพัฒนา frontend
- [x] การจัดวางหน้า
- [ ] ฟังก์ชันการโต้ตอบ
- [ ] การพัฒนา backend
- [ ] การออกแบบ API
- [ ] การออกแบบฐานข้อมูล
- [ ] ขั้นตอนการทดสอบผลการแสดง:
- [x] การวางแผนโปรเจ็กต์
- [x] การวิเคราะห์ความต้องการ
- [x] การวิจัยเทคนิค
- [ ] การออกแบบต้นแบบ
- [ ] ขั้นตอนการพัฒนา
- [ ] การพัฒนา frontend
- [x] การจัดวางหน้า
- [ ] ฟังก์ชันการโต้ตอบ
- [ ] การพัฒนา backend
- [ ] การออกแบบ API
- [ ] การออกแบบฐานข้อมูล
- [ ] การพัฒนา frontend
- [ ] ขั้นตอนการทดสอบ
ข้อผิดพลาดทั่วไปและวิธีแก้ไข
1. การเยื้องไม่ถูกต้อง
❌ ผิด: การเยื้องไม่สม่ำเสมอ
- รายการ 1
- รายการย่อย 1.1
- รายการย่อย 1.2 ← ข้อผิดพลาดในการเยื้อง
✅ ถูกต้อง: รักษาการเยื้องอย่างสม่ำเสมอ
- รายการ 1
- รายการย่อย 1.1
- รายการย่อย 1.22. บรรทัดว่างระหว่างรายการ
❌ ผิด: บรรทัดว่างที่ไม่จำเป็นทำให้รายการขาดตอน
- รายการ 1
- รายการ 2 ← สิ่งนี้จะสร้างสองรายการแยกกัน
✅ ถูกต้อง: รายการที่ต่อเนื่อง
- รายการ 1
- รายการ 23. ขาดช่องว่างหลังตัวเลข
❌ ผิด:
1.รายการแรก ← ขาดช่องว่าง
2.รายการที่สอง
✅ ถูกต้อง:
1. รายการแรก
2. รายการที่สองการจัดการกรณีพิเศษ
การหลีกเลี่ยงสัญลักษณ์รายการ
หากจำเป็นต้องแสดงสัญลักษณ์รายการที่จุดเริ่มต้นของบรรทัดแต่ไม่สร้างรายการ:
\- นี่ไม่ใช่รายการ
\* นี่ก็ไม่ใช่รายการ
\1. นี่ไม่ใช่รายการแบบมีลำดับผลการแสดง:
- นี่ไม่ใช่รายการ * นี่ก็ไม่ใช่รายการ \1. นี่ไม่ใช่รายการแบบมีลำดับ
โค้ดในรายการ
- ติดตั้ง `npm install package-name`
- รัน `npm start`
- เข้าถึง `http://localhost:3000` ในเบราว์เซอร์ผลการแสดง:
- ติดตั้ง
npm install package-name - รัน
npm start - เข้าถึง
http://localhost:3000ในเบราว์เซอร์
ลิงก์ในรายการ
- [GitHub](https://github.com) - แพลตฟอร์มโฮสต์โค้ด
- [Stack Overflow](https://stackoverflow.com) - เว็บไซต์ถามตอบ
- [MDN](https://developer.mozilla.org) - เอกสารสำหรับนักพัฒนาผลการแสดง:
- GitHub - แพลตฟอร์มโฮสต์โค้ด
- Stack Overflow - เว็บไซต์ถามตอบ
- MDN - เอกสารสำหรับนักพัฒนา
แนวทางปฏิบัติที่ดีที่สุด
1. รักษาความสอดคล้อง
✅ แนะนำ: ใช้ยัติภังค์แบบสม่ำเสมอ
- รายการ A
- รายการ B
- รายการ C
❌ ไม่แนะนำ: ใช้สัญลักษณ์ผสมกัน
- รายการ A
* รายการ B
+ รายการ C2. ใช้การซ้อนอย่างเหมาะสม
✅ แนะนำ: การซ้อนอย่างพอเหมาะ
- ฟังก์ชันหลัก
- การจัดการผู้ใช้
- การจัดการเนื้อหา
- ฟังก์ชันเสริม
- บันทึกข้อมูล
- สำรองข้อมูล
❌ ไม่แนะนำ: การซ้อนลึกเกินไป
- ฟังก์ชัน
- ฟังก์ชันหลัก
- ฟังก์ชันหลัก
- ฟังก์ชันพื้นฐาน
- ฟังก์ชันพื้นฐาน ← ลึกเกินไป3. การจัดระเบียบแบบมีความหมาย
✅ แนะนำ: จัดกลุ่มตามตรรกะ
## เครื่องมือพัฒนา
- ตัวแก้ไขโค้ด
- การควบคุมเวอร์ชัน
- เครื่องมือดีบัก
## เครื่องมือออกแบบ
- การออกแบบต้นแบบ
- การประมวลผลภาพ
- การออกแบบอินเทอร์เฟซ
❌ ไม่แนะนำ: การซ้อนโดยไม่มีตรรกะ
- ตัวแก้ไขโค้ด
- การออกแบบต้นแบบ
- การควบคุมเวอร์ชัน
- การประมวลผลภาพHTML เอาต์พุต
รายการ Markdown แปลงเป็น HTML:
- รายการ 1
- รายการ 2แปลงเป็น:
<ul>
<li>รายการ 1</li>
<li>รายการ 2</li>
</ul>1. รายการ 1
2. รายการ 2แปลงเป็น:
<ol>
<li>รายการ 1</li>
<li>รายการ 2</li>
</ol>ตัวอย่างการใช้งานจริง
รายการซื้อของ
## รายการซื้อของวันนี้
### ของใช้ในชีวิตประจำวัน
- [ ] แชมพู
- [ ] ยาสีฟัน
- [x] ผ้าเช็ดตัว
### อาหาร
- [ ] นม
- [ ] ขนมปัง
- [x] ไข่
- [ ] ผลไม้
- [ ] แอปเปิ้ล
- [x] กล้วย
- [ ] ส้มแผนการเรียนรู้
## แผนการเรียนรู้เดือนนี้
1. **สัปดาห์แรก**: ความรู้พื้นฐาน
- [x] อ่านบทช่วยสอนบทที่ 1-3
- [x] ทำแบบฝึกหัด 1-10
- [ ] ดูวิดีโอบทเรียน 1-5
2. **สัปดาห์ที่สอง**: โปรเจ็กต์ปฏิบัติ
- [ ] สร้างโปรเจ็กต์ง่ายๆ
- [ ] ใช้ฟังก์ชันพื้นฐาน
- [ ] เพิ่มการออกแบบสไตล์
3. **สัปดาห์ที่สาม**: เนื้อหาขั้นสูง
- [ ] เรียนรู้คุณสมบัติขั้นสูง
- [ ] เพิ่มประสิทธิภาพโปรเจ็กต์
- [ ] เขียนกรณีทดสอบ
4. **สัปดาห์ที่สี่**: สรุปและทบทวน
- [ ] จัดระเบียบบันทึกการเรียนรู้
- [ ] เตรียมโปรเจ็กต์ปลายภาค
- [ ] ทบทวนเนื้อหาสำคัญรายการฟังก์ชัน API
## จุดสิ้นสุด API
### การจัดการผู้ใช้
1. `GET /api/users` - รับรายการผู้ใช้
- รองรับการแบ่งหน้า
- รองรับการกรองค้นหา
2. `POST /api/users` - สร้างผู้ใช้ใหม่
- ต้องมีสิทธิ์ผู้ดูแลระบบ
- ตรวจสอบความซ้ำของอีเมล
3. `PUT /api/users/:id` - อัปเดตข้อมูลผู้ใช้
- ผู้ใช้สามารถอัปเดตข้อมูลของตัวเองเท่านั้น
- ผู้ดูแลระบบสามารถอัปเดตผู้ใช้ใดๆ ก็ได้
### การจัดการเนื้อหา
- `GET /api/posts` - รับรายการบทความ
- `POST /api/posts` - สร้างบทความใหม่
- `DELETE /api/posts/:id` - ลบบทความไวยากรณ์ที่เกี่ยวข้อง
- รายการงาน - ฟังก์ชันงานขยาย
- รายการคำนิยาม - คำศัพท์และคำนิยาม
- ไวยากรณ์อ้างอิง - อ้างอิงข้อความ
- ไวยากรณ์โค้ด - การจัดรูปแบบโค้ด
แบบฝึกหัด
สร้างรายการประเภทต่อไปนี้:
- โครงสร้างโปรเจ็กต์ที่ซ้อนกันสามระดับ
- รายการขั้นตอนทางเทคนิคที่มีตัวอย่างโค้ด
- รายการที่ซับซ้อนที่ผสมรายการแบบมีลำดับและแบบไม่มีลำดับ
- รายการโปรเจ็กต์ที่รวมสถานะงาน