Markdown อธิบายใน 5 นาที

คุณอาจเคยใช้ Markdown โดยไม่รู้ตัว เคยพิมพ์ **bold** ในข้อความ Slack ไหม? เขียน README บน GitHub? จัดรูปแบบโพสต์ Reddit? นั่นคือ Markdown

Markdown เป็นวิธีเบาๆ ในการจัดรูปแบบข้อความธรรมดาด้วยสัญลักษณ์ง่ายๆ แทนที่จะคลิกปุ่มแถบเครื่องมือสำหรับตัวหนา ตัวเอียง หัวข้อ และรายการ คุณแค่พิมพ์ตัวอักษรไม่กี่ตัวที่ระบุการจัดรูปแบบที่ต้องการ มันถูกสร้างในปี 2004 โดย John Gruber และ Aaron Swartz และตั้งแต่นั้นมาก็กลายเป็นภาษาจัดรูปแบบมาตรฐานสำหรับนักพัฒนา นักเขียน และใครก็ตามที่ทำงานกับข้อความบนเว็บ

ทำไม Markdown ถึงมีอยู่

ก่อน Markdown การจัดรูปแบบข้อความสำหรับเว็บหมายถึงการเขียน HTML เพื่อทำให้คำเป็นตัวหนา คุณต้องพิมพ์ <strong>bold</strong> เพื่อสร้างรายการ คุณต้องใช้ <ul><li>item</li></ul> HTML ทรงพลังแต่ยืดยาวและอ่านยากในรูปแบบดิบ

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

ไวยากรณ์สำคัญ

นี่คือทุกอย่างที่ต้องรู้เพื่อเริ่มใช้ Markdown อย่างมีประสิทธิภาพ

หัวข้อ

ใช้เครื่องหมาย hash (#) เพื่อสร้างหัวข้อ hash มากขึ้นหมายถึงหัวข้อเล็กลง

# หัวข้อ 1 (ใหญ่ที่สุด)
## หัวข้อ 2
### หัวข้อ 3
#### หัวข้อ 4

ตัวหนาและตัวเอียง

ครอบข้อความด้วยเครื่องหมายดอกจันหรือขีดล่าง:

**ข้อความตัวหนา**
*ข้อความตัวเอียง*
***ตัวหนาและตัวเอียง***

รายการ

รายการไม่เรียงลำดับใช้เครื่องหมายขีด ดอกจัน หรือบวก รายการเรียงลำดับใช้ตัวเลข

- รายการแรก
- รายการที่สอง
- รายการที่สาม

1. ขั้นตอนแรก
2. ขั้นตอนที่สอง
3. ขั้นตอนที่สาม

ลิงก์

วงเล็บเหลี่ยมสำหรับข้อความ วงเล็บกลมสำหรับ URL:

[คลิกที่นี่](https://example.com)

รูปภาพ

เหมือนลิงก์ แต่มีเครื่องหมายอัศเจรีย์ด้านหน้า:

![ข้อความอธิบาย](image-url.jpg)

คำพูดอ้างอิง

ใช้เครื่องหมายมากกว่า:

> นี่คือคำพูดอ้างอิง จะถูกเยื้องและจัดรูปแบบแตกต่าง

โค้ด

ใช้ backtick สำหรับโค้ดในบรรทัด และ backtick สามตัวสำหรับบล็อกโค้ด:

ใช้ฟังก์ชัน `print()` เพื่อแสดงข้อความ

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

```python
def hello():
    print("Hello, world!")
```

เส้นแบ่ง

เครื่องหมายขีดสามตัวขึ้นไป ดอกจัน หรือขีดล่าง:

---

ตาราง

ใช้ท่อและขีด:

| ชื่อ | บทบาท | สถานที่ |
| --- | --- | --- |
| Alice | นักพัฒนา | เบอร์ลิน |
| Bob | นักออกแบบ | ลอนดอน |

Markdown ใช้ที่ไหนบ้าง

Markdown มีอยู่ทุกที่:

การพัฒนาซอฟต์แวร์

• GitHub, GitLab, Bitbucket: README, issues, pull requests และเอกสารล้วนเขียนด้วย Markdown
• Stack Overflow: คำถามและคำตอบใช้การจัดรูปแบบ Markdown
• เอกสารโค้ด: ตัวสร้างเอกสารหลายตัว (Docusaurus, MkDocs, Jekyll) ใช้ Markdown เป็นรูปแบบต้นทาง

การสื่อสาร

• Slack: รองรับ Markdown บางส่วนสำหรับจัดรูปแบบข้อความ
• Discord: ใช้ Markdown สำหรับตัวหนา ตัวเอียง บล็อกโค้ด และอื่นๆ
• Reddit: โพสต์และความคิดเห็นจัดรูปแบบด้วย Markdown

การเขียนและเผยแพร่

• บล็อก: ตัวสร้างเว็บไซต์แบบ static หลายตัวใช้ไฟล์ Markdown เป็นแหล่งเนื้อหา
• หนังสือ: เครื่องมือเผยแพร่หลายตัวรับต้นฉบับ Markdown
• บันทึก: แอปเช่น Obsidian, Notion, Bear และ Typora สร้างรอบ Markdown

เอกสาร

• เอกสารเทคนิค: เอกสาร API คู่มือผู้ใช้ และวิกิมักใช้ Markdown
• ฐานความรู้ภายใน: หลายทีมใช้วิกิที่ใช้ Markdown

รสชาติของ Markdown

สิ่งหนึ่งที่ต้องรู้: มี "รสชาติ" ต่างๆ ของ Markdown ไวยากรณ์หลักเหมือนกันทุกที่ แต่บางแพลตฟอร์มเพิ่มส่วนขยาย:

ความแตกต่างส่วนใหญ่อยู่ในฟีเจอร์ขั้นสูง พื้นฐาน (หัวข้อ ตัวหนา ตัวเอียง รายการ ลิงก์ รูปภาพ โค้ด) ทำงานเหมือนกันทุกที่

ข้อผิดพลาดที่พบบ่อย

ลืมบรรทัดว่าง

Markdown ต้องการบรรทัดว่างก่อนและหลังองค์ประกอบหลายอย่าง หัวข้อต้องมีบรรทัดว่างก่อน รายการต้องมีบรรทัดว่างก่อนและหลัง การลืมบรรทัดว่างเหล่านี้เป็นสาเหตุที่พบบ่อยที่สุดของปัญหาการแสดงผล

เครื่องหมายรายการที่ไม่สม่ำเสมอ

การผสม -, * และ + ในรายการเดียวกันอาจทำให้แสดงผลผิดพลาด เลือกอันเดียวแล้วใช้ตลอด

เว้นวรรคหลังสัญลักษณ์

ตัวประมวลผล Markdown บางตัวต้องการเว้นวรรคหลัง # ในหัวข้อ และหลัง - ในรายการ ใส่เว้นวรรคเสมอเพื่อความปลอดภัย

# หัวข้อถูกต้อง
#หัวข้อไม่ถูกต้อง

- รายการถูกต้อง
-รายการไม่ถูกต้อง

ทำไม Markdown ถึงคุ้มค่าที่จะเรียนรู้

Markdown ใช้เวลาเรียนรู้ห้านาทีและประหยัดเวลาหลายชั่วโมงในระยะยาว เมื่อรู้แล้ว คุณสามารถ:

• เขียนเอกสารที่แสดงผลสวยงามบน GitHub
• จัดรูปแบบข้อความใน Slack และ Discord โดยไม่ต้องแตะเมาส์
• จดบันทึกที่มีโครงสร้างที่พกพาได้ข้ามแอป
• สร้างบล็อกโพสต์และเนื้อหาเว็บจากไฟล์ข้อความธรรมดา
• ร่วมมือกันทำงานเอกสารข้อความโดยไม่มีปัญหาความเข้ากันได้ของรูปแบบ

อัตราส่วนการลงทุนต่อผลตอบแทนดีที่สุดอย่างหนึ่งในโลกเทคโนโลยี

เริ่มเขียน Markdown ตอนนี้เลย:

• เขียนและดูตัวอย่าง Markdown
• เครื่องมือดูตัวอย่าง Markdown

ฟรี ในเบราว์เซอร์ พร้อมดูตัวอย่างแบบเรียลไทม์ขณะพิมพ์