ไวยากรณ์ขยายของ Markdown
ไวยากรณ์พื้นฐานของ Markdown เพียงพอสำหรับองค์ประกอบหลักของเอกสาร แต่ยังไม่ครอบคลุมทุกสถานการณ์เฉพาะ ไวยากรณ์ขยายจึงมีบทบาทสำคัญในการเพิ่มความสามารถให้เอกสารของคุณ
ไวยากรณ์ขยาย คือฟีเจอร์เพิ่มเติมที่อยู่เหนือสเปคดั้งเดิมของ Markdown โดยมักถูกเพิ่มโดยตัวประมวลผล Markdown ต่าง ๆ เพื่อรองรับความสามารถเสริม
สิ่งที่ถือเป็นไวยากรณ์ขยาย
องค์ประกอบที่มักพบ เช่น:
- ตาราง — สร้างตารางข้อมูล
- รั้วโค้ด — โค้ดบล็อกพร้อมไฮไลต์ไวยากรณ์
- เชิงอรรถ — เพิ่มอ้างอิงเชิงอรรถ
- ID ของหัวเรื่อง — เพิ่ม ID กำหนดเองให้หัวเรื่อง
- รายการคำจำกัดความ — รายการคำศัพท์และคำอธิบาย
- ขีดฆ่า — ขีดฆ่าข้อความ
- รายการงาน — เช็กลิสต์พร้อมช่องทำเครื่องหมาย
- อีโมจิ — แสดงสัญลักษณ์อารมณ์
- ไฮไลต์ — เน้นข้อความสำคัญ
- ตัวห้อย/ตัวยก — ใช้บ่อยในนิพจน์คณิตศาสตร์
การรองรับบนแพลตฟอร์ม
ควรทราบว่า “ไม่ใช่ทุกแพลตฟอร์ม Markdown จะรองรับไวยากรณ์ขยายเสมอไป” ก่อนใช้งานควรตรวจสอบตัวประมวลผลเป้าหมายของคุณว่ารองรับฟีเจอร์นั้นหรือไม่
แพลตฟอร์ม/เครื่องมือที่รองรับได้ดี เช่น:
- GitHub Flavored Markdown (GFM)
- GitLab Flavored Markdown
- Typora
- Obsidian
- VitePress
- Hugo
ตัวอย่างสั้น ๆ
ตาราง
markdown
| ชื่อ | อายุ | อาชีพ |
|-----|------|-------|
| Zhang San | 25 | วิศวกร |
| Li Si | 30 | นักออกแบบ |รั้วโค้ด
markdown
```javascript
function hello() {
console.log("Hello, World!");
}
```รายการงาน
markdown
- [x] วางแผนโครงการ
- [ ] เขียนโค้ด
- [ ] ทดสอบฟีเจอร์
- [ ] ดีพลอยขึ้นระบบขีดฆ่า
markdown
~~ข้อความนี้ถูกขีดฆ่า~~ลิงก์อัตโนมัติ
markdown
เยี่ยมชม https://www.markdownlang.com เพื่อดูข้อมูลเพิ่มเติม
ติดต่อ: example@domain.comเชิงอรรถ
markdown
นี่คือตัวอย่างเชิงอรรถ[^1]
[^1]: เนื้อหาเชิงอรรถรายการคำจำกัดความ
markdown
Markdown
: ภาษามาร์กอัปแบบเบา
HTML
: ภาษามาร์กอัปสำหรับเว็บ
: มาตรฐานการสร้างหน้าเว็บสูตรคณิตศาสตร์ (ตัวอย่าง)
markdown
อินไลน์: $E = mc^2$
บล็อก:
$$
\sum_{i=1}^n a_i = 0
$$Mermaid (ไดอะแกรม)
markdown
```mermaid
graph TD
A[เริ่ม] --> B{เข้าใจหรือไม่?}
B -->|ใช่| C[เรียนต่่อ]
B -->|ไม่| D[อ่านซ้ำ]
D --> B
C --> E[จบ]
```ลำดับการเรียนรู้ที่แนะนำ
- ตาราง — ใช้งานบ่อยและจับต้องได้
- รั้วโค้ด — สำคัญสำหรับงานเขียนโค้ด
- รายการงาน — เหมาะกับการจัดการงาน/โครงการ
- ขีดฆ่า — เข้าใจง่าย ใช้บ่อย
- เชิงอรรถ — จำเป็นในงานเขียนเชิงวิชาการ
- รายการคำจำกัดความ — อธิบายคำศัพท์
- หัวเรื่องพร้อม ID — ลิงก์ขั้นสูง/สารบัญ
- ไฮไลต์ — เน้นใจความสำคัญ
ข้อควรคำนึงเรื่องความเข้ากันได้
- ทดสอบบนแพลตฟอร์มเป้าหมายของคุณ
- เตรียมทางเลือกเมื่อฟีเจอร์ไม่รองรับ
- ระบุในเอกสารว่าใช้ไวยากรณ์ขยายใดบ้าง
- สร้างมาตรฐานภายในทีมเพื่อความสม่ำเสมอ
ก้าวถัดไป
เลือกหัวข้อที่สนใจและเริ่มเรียนรู้: