Cú pháp tiêu đề Markdown
Tiêu đề là phần tử quan trọng nhất trong việc tổ chức cấu trúc tài liệu. Markdown hỗ trợ hai loại cú pháp tiêu đề: kiểu ATX và kiểu Setext.
Tiêu đề kiểu ATX
Để tạo tiêu đề, hãy thêm dấu hash (#) ở phía trước từ hoặc cụm từ. Số lượng dấu hash biểu thị cấp độ tiêu đề.
# Tiêu đề cấp 1
## Tiêu đề cấp 2
### Tiêu đề cấp 3
#### Tiêu đề cấp 4
##### Tiêu đề cấp 5
###### Tiêu đề cấp 6Hiệu ứng kết xuất
Tiêu đề cấp 1
Tiêu đề cấp 2
Tiêu đề cấp 3
Tiêu đề cấp 4
Tiêu đề cấp 5
Tiêu đề cấp 6
Cú pháp đóng tùy chọn
Bạn có thể tùy chọn "đóng" tiêu đề kiểu ATX, điều này chỉ để làm đẹp:
# Tiêu đề cấp 1 #
## Tiêu đề cấp 2 ##
### Tiêu đề cấp 3 ###Số lượng # ở cuối dòng không cần giống với phần đầu, số lượng ký tự hash ở đầu dòng quyết định cấp độ tiêu đề.
Tiêu đề kiểu Setext
Cũng có thể thêm bất kỳ số lượng ký tự = nào bên dưới văn bản để đánh dấu tiêu đề cấp 1, hoặc ký tự - để đánh dấu tiêu đề cấp 2.
Tiêu đề cấp 1
========
Tiêu đề cấp 2
--------Hiệu ứng kết xuất
Tiêu đề cấp 1
Tiêu đề cấp 2
Thực hành tốt nhất cho tiêu đề
Xem xét tính tương thích
Khi không có khoảng trắng giữa dấu hash (#) và văn bản tiêu đề, mỗi ứng dụng Markdown xử lý khác nhau. Để tương thích, vui lòng thêm một khoảng trắng giữa dấu hash và văn bản tiêu đề.
| ✅ Khuyến nghị | ❌ Không khuyến nghị |
|---|---|
# Đây là tiêu đề | #Đây là tiêu đề |
Sử dụng dòng trống
Để tương thích, vui lòng thêm dòng trống cả trước và sau tiêu đề.
Đây là một đoạn văn bản.
# Đây là tiêu đề
Đây là một đoạn văn bản khác.Cấp độ tiêu đề
- Mỗi tài liệu nên chỉ sử dụng một tiêu đề cấp 1
- Duy trì logic cấp độ tiêu đề, không nhảy cấp
- Tiêu đề nên phản ánh cấu trúc phân cấp của tài liệu
Quy tắc văn bản tiêu đề
- Văn bản tiêu đề ngắn gọn và rõ ràng
- Tránh sử dụng dấu câu (đặc biệt là dấu chấm)
- Sử dụng danh động từ hoặc cụm danh từ
- Duy trì định dạng tiêu đề cùng cấp nhất quán
Đầu ra HTML
Tiêu đề Markdown sẽ được chuyển đổi thành thẻ tiêu đề HTML tương ứng:
# Tiêu đề → <h1>Tiêu đề</h1>
## Tiêu đề → <h2>Tiêu đề</h2>
### Tiêu đề → <h3>Tiêu đề</h3>
#### Tiêu đề → <h4>Tiêu đề</h4>
##### Tiêu đề → <h5>Tiêu đề</h5>
###### Tiêu đề → <h6>Tiêu đề</h6>ID tiêu đề (Tính năng mở rộng)
Nhiều bộ xử lý Markdown sẽ tự động tạo ID cho tiêu đề để tạo liên kết neo:
<h1 id="markdown-cú-pháp-tiêu-đề">Cú pháp tiêu đề Markdown</h1>Bằng cách này bạn có thể liên kết đến một tiêu đề cụ thể:
[Liên kết đến tiêu đề](#markdown-cú-pháp-tiêu-đề)Ví dụ ứng dụng thực tế
Dưới đây là một ví dụ tài liệu thể hiện cấu trúc tiêu đề tốt:
# Hướng dẫn sử dụng sản phẩm
## Bắt đầu nhanh
### Các bước cài đặt
#### Yêu cầu hệ thống
#### Tải xuống và cài đặt
### Cấu hình cơ bản
## Tính năng nâng cao
### Cài đặt tùy chỉnh
### Quản lý plugin
## Khắc phục sự cố
### Câu hỏi thường gặp
### Liên hệ hỗ trợCấu trúc tiêu đề phân cấp rõ ràng này làm cho tài liệu dễ đọc và điều hướng hơn.