คู่มือ Markdown สำหรับนักเขียนและนักพัฒนา

Markdown คือรูปแบบการเขียนที่ใกล้เคียงกับมาตรฐานสากลของอินเทอร์เน็ตมากที่สุด ไม่ว่าจะเป็น GitHub READMEs, Notion, ข้อความ Slack, เอกสารประกอบ, บล็อกโพสต์ และบันทึกของนักพัฒนา เรียนรู้ครั้งเดียวแล้วใช้ได้ทุกที่ — ตลอดอาชีพการงานของคุณ

Markdown คืออะไร?

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

This **bold text** and *italic text* render instantly.

แสดงผลเป็น: This bold text and italic text render instantly.

ข้อความดิบยังคงอ่านออกได้สบาย — แม้ก่อนที่จะแปลงเป็น HTML

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

หัวข้อ

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

ใช้หัวข้อเพื่อสร้างลำดับชั้นในเอกสาร # H1 มักใช้เป็นชื่อหน้า — ควรมีเพียงอันเดียวต่อเอกสาร

การเน้นข้อความ

**bold text**
*italic text*
***bold and italic***
~~strikethrough~~

รายการ

Unordered list:
- Item one
- Item two
  - Nested item (indent with 2 spaces)
  - Another nested item
- Item three

Ordered list:
1. First step
2. Second step
3. Third step

ลิงก์และรูปภาพ

[Link text](https://example.com)
[Link with title](https://example.com "Hover tooltip")

![Alt text for image](https://example.com/image.jpg)
![Alt text](./local-image.png "Optional title")

Blockquotes

> This is a blockquote.
> It can span multiple lines.

> You can nest blockquotes:
> > Like this.

เส้นแบ่งแนวนอน

---

(ขีดกลาง ดอกจัน หรือขีดล่างสามตัวขึ้นไปในบรรทัดเดียวกัน)

Code blocks

Inline code ใช้ backtick เดี่ยว:

Use the `console.log()` function for debugging.

Fenced code blocks ใช้ triple backtick พร้อมระบุภาษาเพื่อเปิดใช้งาน syntax highlighting:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

ภาษาที่รองรับได้แก่ javascript, typescript, python, bash, sql, json, yaml, css, html, go, rust และอีกหลายสิบภาษา — ขึ้นอยู่กับ renderer ที่ใช้

ตาราง

ตาราง Markdown ใช้เครื่องหมาย pipe และขีดกลาง:

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Cell A   | Cell B   | Cell C   |
| Cell D   | Cell E   | Cell F   |

จัดแนวคอลัมน์ด้วยเครื่องหมายโคลอนในแถวคั่น:

| Left | Center | Right |
|:-----|:------:|------:|
| L    |   C    |     R |

ตารางเป็นส่วนหนึ่งของ GitHub Flavored Markdown (GFM) ไม่ใช่ Markdown มาตรฐาน รองรับใน GitHub, VS Code, แพลตฟอร์มเอกสารส่วนใหญ่ และ MDX

Task lists (GFM)

- [x] Write the introduction
- [x] Add code examples
- [ ] Review and publish
- [ ] Add images

แสดงเป็น checkbox แบบโต้ตอบบน GitHub รองรับอย่างกว้างขวางใน Markdown renderer ยุคใหม่

รูปแบบของ Markdown

Markdown ดั้งเดิมถูกออกแบบให้เรียบง่ายโดยตั้งใจ ส่งผลให้มีส่วนขยายเกิดขึ้นมากมาย:

รูปแบบ	ใช้ใน	ฟีเจอร์เพิ่มเติม
CommonMark	หลายแพลตฟอร์ม	สเปกที่เป็นมาตรฐาน
GitHub Flavored (GFM)	GitHub, GitLab	ตาราง, task lists, strikethrough, autolinks
MDX	React sites	JSX components ภายใน Markdown
Pandoc Markdown	เอกสารวิชาการ	Footnotes, citations, math
MultiMarkdown	เครื่องมือบน macOS	ตาราง, metadata, footnotes

หากไม่แน่ใจ ให้ใช้ GFM — เป็นรูปแบบขยายที่ได้รับการรองรับอย่างกว้างขวางที่สุด

Front matter

Markdown processor หลายตัวรองรับ YAML front matter ที่ด้านบนของไฟล์สำหรับเก็บ metadata:

---
title: "My Article Title"
date: "2026-03-24"
author: "Jane Doe"
tags: ["markdown", "writing", "tools"]
published: true
---

# Article content starts here

Front matter จะถูกแยกวิเคราะห์ออกจากเนื้อหาเอกสาร และนำไปใช้สำหรับสิ่งต่าง ๆ เช่น ชื่อหน้า, วันที่ และ SEO metadata

MDX: Markdown + JSX

MDX คือ Markdown ที่สามารถมี React components ได้ เหมาะสำหรับเอกสารประกอบและบล็อกโพสต์บนเว็บไซต์ที่ใช้ React (Next.js, Gatsby, Astro):

import { Alert } from '../components/Alert'

## Important note

<Alert type="warning">
  This feature is deprecated in v3.
</Alert>

Regular **Markdown** content continues below.

นี่คือการผสมผสานความเรียบง่ายของ Markdown เข้ากับพลังของ interactive components

การ escape อักขระพิเศษ

ใส่ backslash นำหน้าอักขระพิเศษของ Markdown เพื่อแสดงผลตามตัวอักษร:

\*not italic\*
\# not a heading
\[not a link\]

เคล็ดลับสำหรับเอกสาร Markdown ที่ดีขึ้น

1. หนึ่งประโยคต่อหนึ่งบรรทัด — ทำให้ diff สะอาดขึ้นใน Git และแสดงผลเหมือนกันเพราะ Markdown ไม่สนใจการขึ้นบรรทัดใหม่เดี่ยว
2. เว้นบรรทัดว่างระหว่างบล็อก — เว้นบรรทัดว่างระหว่างย่อหน้า, หัวข้อ, รายการ และ code blocks เสมอ
3. ใช้เครื่องหมายรายการอย่างสม่ำเสมอ — เลือก - หรือ * สำหรับ unordered lists แล้วใช้ให้เหมือนกันตลอดทั้งโปรเจกต์
4. ใช้ reference links สำหรับ URL ที่ซ้ำกัน — กำหนดครั้งเดียว ใช้ได้หลายครั้ง:

   See the [documentation][docs] and [changelog][docs].
   [docs]: https://example.com/docs
   

5. ใส่ alt text ทุกรูปภาพ — จำเป็นสำหรับ accessibility และ SEO

การตรวจสอบความอ่านง่าย

Markdown ช่วยให้เขียนได้ง่าย — แต่การเขียนที่ง่ายอาจทำให้ได้ข้อความที่อ่านยาก ใช้เครื่องมือ Readability Score ของเราเพื่อตรวจสอบระดับ Flesch-Kincaid, ความซับซ้อนของประโยค และการใช้ passive voice ตั้งเป้าให้ภาษาชัดเจนและกระชับในระดับชั้นเรียนที่ 8–10 สำหรับผู้อ่านทั่วไป

Markdown คือเครื่องมือที่ใช้เวลาเรียนรู้เพียง 10 นาที แต่ให้ผลตอบแทนตลอดชีวิต เริ่มเขียนด้วย Markdown วันนี้เลย — ผู้ร่วมงานในอนาคต (และตัวคุณเองในอนาคต) จะขอบคุณคุณ