คู่มือไวยากรณ์ Markdown: เอกสารอ้างอิงฉบับสมบูรณ์พร้อมตัวอย่าง

คู่มือไวยากรณ์ Markdown

Markdown เป็นภาษามาร์กอัปแบบเบาที่แปลงข้อความธรรมดาเป็น HTML ที่จัดรูปแบบแล้ว สร้างโดย John Gruber ในปี 2004 มันได้กลายเป็นรูปแบบการเขียนมาตรฐานสำหรับเอกสารประกอบ ไฟล์ README และเนื้อหาทางเทคนิคทั่วทั้งเว็บ

หัวข้อ

ใช้สัญลักษณ์ # หนึ่ง # สำหรับระดับบนสุด ถึงหกตัวสำหรับระดับลึกสุด:

# หัวข้อ 1
## หัวข้อ 2
### หัวข้อ 3
#### หัวข้อ 4

ระดับควรเพิ่มขึ้นทีละหนึ่ง — การข้ามจาก ## ไป #### อาจทำให้โปรแกรมอ่านหน้าจอสับสน

การจัดรูปแบบข้อความ

**ข้อความตัวหนา** หรือ __ข้อความตัวหนา__
*ข้อความตัวเอียง* หรือ _ข้อความตัวเอียง_
**_ตัวหนาและตัวเอียง_**
~~ข้อความขีดทับ~~

ลิงก์

[ข้อความลิงก์](https://example.com)
[ลิงก์พร้อมชื่อ](https://example.com "ชื่อ")
[แบบอ้างอิง][ref-id]
[ref-id]: https://example.com
<contact@example.com>

รูปภาพ

![ข้อความทดแทน](/path/to/image.jpg)
[![ข้อความทดแทน](/path/to/image.jpg)](https://example.com)

ข้อความทดแทนสำคัญสำหรับการเข้าถึงและ SEO — มันแสดงเมื่อรูปภาพโหลดไม่สำเร็จ

รายการ

รายการไม่เรียงลำดับใช้ -, * หรือ + รายการเรียงลำดับใช้ตัวเลข:

- รายการหนึ่ง         1. รายการแรก
- รายการสอง         2. รายการที่สอง
  - รายการซ้อน        1. รายการซ้อน

โค้ด

โค้ดในบรรทัดใช้ backtick เดียว: `printf()`

บล็อกโค้ดใช้ backtick สามตัวพร้อมตัวระบุภาษาเพิ่มเติม:

```python
def greet(name):
    return f"Hello, {name}!"

ภาษาที่รองรับ: `javascript`, `python`, `html`, `css`, `json`, `bash`, `sql`, `yaml`

## บล็อกคำพูด

```markdown
> นี่คือบล็อกคำพูด
> > บล็อกคำพูดซ้อนก็รองรับ

ใช้ทั่วไปสำหรับคำอธิบายประกอบ บันทึก และการอ้างอิงแหล่งภายนอก

เส้นคั่นแนวนอน

ขีดสามตัวหรือมากกว่า ดอกจัน หรือขีดล่างในบรรทัด:

---
***
___

ตาราง

ไพพ์และขีดกำหนดคอลัมน์ ทวิภาคควบคุมการจัดตำแหน่ง:

| ซ้าย | กลาง | ขวา |
| :--- | :----: | ----: |
| A1   | B1     | C1    |

ส่วนขยาย GitHub Flavored Markdown

GitHub Flavored Markdown (GFM) เพิ่มคุณสมบัติที่มีประโยชน์:

- [x] งานที่เสร็จแล้ว     # รายการงาน
- [ ] งานที่ยังไม่เสร็จ

:smile: :rocket: :warning:    # รหัสย่ออีโมจิ

~~ข้อความขีดทับ~~        # ขีดทับ

GFM ยังสร้างลิงก์อัตโนมัติจาก URL — www.example.com กลายเป็นคลิกได้โดยไม่ต้องครอบด้วย < >

การหลีกอักขระพิเศษ

นำหน้าด้วย \ เพื่อแสดงอักขระ Markdown ตามตัวอักษร:

\*นี่ไม่ใช่ตัวเอียง\*
\# นี่ไม่ใช่หัวข้อ

อักขระที่ต้องหลีก: \ ` * _ { } [ ] ( ) # + - . ! | ~

ตัวอย่าง Markdown ออนไลน์

ใช้เครื่องมือแสดงตัวอย่าง Markdown เพื่อเขียนและดูตัวอย่าง Markdown แบบเรียลไทม์ ตัวอย่างสดอัปเดตขณะคุณพิมพ์ แสดงให้เห็นว่าหัวข้อ ลิงก์ รูปภาพ บล็อกโค้ด และตารางจะแสดงผลอย่างไร