Cú pháp danh sách

Danh sách là cách tổ chức thông tin quan trọng, Markdown hỗ trợ danh sách có thứ tự và danh sách không có thứ tự, cũng có thể tạo danh sách lồng nhau và danh sách công việc.

Danh sách không có thứ tự

Cú pháp cơ bản

Sử dụng -, * hoặc + để tạo danh sách không có thứ tự:

markdown

- Mục 1
- Mục 2
- Mục 3

* Mục 1
* Mục 2
* Mục 3

+ Mục 1
+ Mục 2
+ Mục 3

Hiệu ứng kết xuất:

Mục 1
Mục 2
Mục 3

Gợi ý chọn ký hiệu

Ký hiệu	Đặc điểm	Trường hợp khuyến nghị
`-`	Phổ biến nhất, đơn giản	Khuyến nghị chung
`*`	Thống nhất với cú pháp nhấn mạnh	Giữ phong cách thống nhất
`+`	Ít sử dụng	Cần phân biệt đặc biệt

Gợi ý: Duy trì tính nhất quán của ký hiệu trong toàn bộ tài liệu.

Danh sách có thứ tự

Cú pháp cơ bản

Sử dụng số và dấu chấm để tạo danh sách có thứ tự:

markdown

1. Mục đầu tiên
2. Mục thứ hai
3. Mục thứ ba

Hiệu ứng kết xuất:

Mục đầu tiên
Mục thứ hai
Mục thứ ba

Số thứ tự

Giá trị thực tế của số không quan trọng, Markdown sẽ tự động tạo số thứ tự chính xác:

markdown

1. Mục đầu tiên
3. Mục thứ hai
8. Mục thứ ba

Hiệu ứng kết xuất:

Mục đầu tiên
Mục thứ hai
Mục thứ ba

Số bắt đầu

Có thể chỉ định số bắt đầu:

markdown

3. Mục thứ ba
4. Mục thứ tư
5. Mục thứ năm

Hiệu ứng kết xuất:

Mục thứ ba
Mục thứ tư
Mục thứ năm

Danh sách lồng nhau

Lồng cơ bản

Sử dụng thụt lề (2-4 khoảng trắng) để tạo danh sách lồng nhau:

markdown

- Mục cấp một 1
  - Mục cấp hai 1.1
  - Mục cấp hai 1.2
- Mục cấp một 2
  - Mục cấp hai 2.1
    - Mục cấp ba 2.1.1
    - Mục cấp ba 2.1.2
  - Mục cấp hai 2.2

Hiệu ứng kết xuất:

Mục cấp một 1
- Mục cấp hai 1.1
- Mục cấp hai 1.2
Mục cấp một 2
- Mục cấp hai 2.1
  - Mục cấp ba 2.1.1
  - Mục cấp ba 2.1.2
- Mục cấp hai 2.2

Lồng hỗn hợp

Danh sách có thứ tự và danh sách không có thứ tự có thể lồng nhau:

markdown

1. Mục có thứ tự 1
   - Mục con không có thứ tự 1.1
   - Mục con không có thứ tự 1.2
2. Mục có thứ tự 2
   1. Mục con có thứ tự 2.1
   2. Mục con có thứ tự 2.2
      - Mục cháu không có thứ tự 2.2.1
      - Mục cháu không có thứ tự 2.2.2

Hiệu ứng kết xuất:

Mục có thứ tự 1
- Mục con không có thứ tự 1.1
- Mục con không có thứ tự 1.2
Mục có thứ tự 2
1. Mục con có thứ tự 2.1
2. Mục con có thứ tự 2.2
  - Mục cháu không có thứ tự 2.2.1
  - Mục cháu không có thứ tự 2.2.2

Nội dung nhiều đoạn trong danh sách

Đoạn tiếp theo

Bao gồm nhiều đoạn trong mục danh sách:

markdown

1. Mục đầu tiên

   Đây là đoạn thứ hai của mục đầu tiên. Cần thụt lề để giữ trong mục danh sách.

2. Mục thứ hai

   Đây là đoạn thứ hai của mục thứ hai.
   
   Đây là đoạn thứ ba của mục thứ hai.

3. Mục thứ ba

Hiệu ứng kết xuất:

Mục đầu tiên
Đây là đoạn thứ hai của mục đầu tiên. Cần thụt lề để giữ trong mục danh sách.
Mục thứ hai
Đây là đoạn thứ hai của mục thứ hai.
Đây là đoạn thứ ba của mục thứ hai.
Mục thứ ba

Khối mã

Bao gồm khối mã trong danh sách:

markdown

1. Cài đặt phụ thuộc

   ```bash
   npm install express

Tạo máy chủ

javascript

const express = require('express');
const app = express();

Khởi động máy chủ


### Khối trích dẫn

Bao gồm trích dẫn trong danh sách:

```markdown
1. Chuẩn bị

   > Đảm bảo bạn có đủ dung lượng đĩa
   > Khuyến nghị giữ ít nhất 10GB dung lượng

2. Bắt đầu cài đặt

Danh sách công việc

Cú pháp cơ bản

Sử dụng - [ ] để tạo công việc chưa hoàn thành, - [x] để tạo công việc đã hoàn thành:

markdown

- [x] Công việc đã hoàn thành
- [ ] Công việc chưa hoàn thành
- [x] Công việc đã hoàn thành khác
- [ ] Việc cần làm

Hiệu ứng kết xuất:

[x] Công việc đã hoàn thành
[ ] Công việc chưa hoàn thành
[x] Công việc đã hoàn thành khác
[ ] Việc cần làm

Danh sách công việc lồng nhau

markdown

- [x] Lập kế hoạch dự án
  - [x] Phân tích yêu cầu
  - [x] Nghiên cứu kỹ thuật
  - [ ] Thiết kế nguyên mẫu
- [ ] Giai đoạn phát triển
  - [ ] Phát triển frontend
    - [x] Bố cục trang
    - [ ] Chức năng tương tác
  - [ ] Phát triển backend
    - [ ] Thiết kế API
    - [ ] Thiết kế cơ sở dữ liệu
- [ ] Giai đoạn kiểm tra

Hiệu ứng kết xuất:

[x] Lập kế hoạch dự án
- [x] Phân tích yêu cầu
- [x] Nghiên cứu kỹ thuật
- [ ] Thiết kế nguyên mẫu
[ ] Giai đoạn phát triển
- [ ] Phát triển frontend
  - [x] Bố cục trang
  - [ ] Chức năng tương tác
- [ ] Phát triển backend
  - [ ] Thiết kế API
  - [ ] Thiết kế cơ sở dữ liệu
[ ] Giai đoạn kiểm tra

Lỗi thường gặp và giải pháp

1. Thụt lề không đúng

markdown

❌ Lỗi: Thụt lề không nhất quán
- Mục 1
  - Mục con 1.1
    - Mục con 1.2  ← Lỗi thụt lề

✅ Đúng: Duy trì thụt lề nhất quán
- Mục 1
  - Mục con 1.1
  - Mục con 1.2

2. Dòng trống giữa các mục danh sách

markdown

❌ Lỗi: Dòng trống không cần thiết khiến danh sách bị ngắt
- Mục 1

- Mục 2  ← Điều này tạo hai danh sách độc lập

✅ Đúng: Các mục danh sách liên tục
- Mục 1
- Mục 2

3. Thiếu khoảng trắng sau số

markdown

❌ Lỗi:
1.Mục đầu tiên  ← Thiếu khoảng trắng
2.Mục thứ hai

✅ Đúng:
1. Mục đầu tiên
2. Mục thứ hai

Xử lý trường hợp đặc biệt

Thoát ký hiệu danh sách

Nếu cần hiển thị ký hiệu danh sách ở đầu dòng nhưng không tạo danh sách:

markdown

\- Đây không phải mục danh sách
\* Đây cũng không phải mục danh sách
\1. Đây không phải mục danh sách có thứ tự

Hiệu ứng kết xuất:

- Đây không phải mục danh sách * Đây cũng không phải mục danh sách \1. Đây không phải mục danh sách có thứ tự

Mã trong mục danh sách

markdown

- Cài đặt `npm install package-name`
- Chạy `npm start`
- Truy cập `http://localhost:3000` trong trình duyệt

Hiệu ứng kết xuất:

Cài đặt npm install package-name
Chạy npm start
Truy cập http://localhost:3000 trong trình duyệt

Liên kết trong mục danh sách

markdown

- [GitHub](https://github.com) - Nền tảng lưu trữ mã
- [Stack Overflow](https://stackoverflow.com) - Trang web hỏi đáp
- [MDN](https://developer.mozilla.org) - Tài liệu phát triển

Hiệu ứng kết xuất:

GitHub - Nền tảng lưu trữ mã
Stack Overflow - Trang web hỏi đáp
MDN - Tài liệu phát triển

Thực hành tốt nhất

1. Duy trì tính nhất quán

markdown

✅ Khuyến nghị: Sử dụng thống nhất dấu gạch ngang
- Mục A
- Mục B
- Mục C

❌ Không khuyến nghị: Trộn lẫn ký hiệu
- Mục A
* Mục B
+ Mục C

2. Sử dụng lồng hợp lý

markdown

✅ Khuyến nghị: Lồng vừa phải
- Chức năng chính
  - Quản lý người dùng
  - Quản lý nội dung
- Chức năng phụ
  - Ghi nhật ký
  - Sao lưu dữ liệu

❌ Không khuyến nghị: Lồng quá sâu
- Chức năng
  - Chức năng chính
    - Chức năng cốt lõi
      - Chức năng cơ bản
        - Chức năng cơ bản  ← Quá sâu rồi

3. Tổ chức theo ngữ nghĩa

markdown

✅ Khuyến nghị: Nhóm theo logic
## Công cụ phát triển
- Trình soạn thảo mã
- Kiểm soát phiên bản
- Công cụ gỡ lỗi

## Công cụ thiết kế
- Thiết kế nguyên mẫu
- Xử lý hình ảnh
- Thiết kế giao diện

❌ Không khuyến nghị: Xếp chồng không logic
- Trình soạn thảo mã
- Thiết kế nguyên mẫu
- Kiểm soát phiên bản
- Xử lý hình ảnh

Đầu ra HTML

Danh sách Markdown chuyển đổi thành HTML:

markdown

- Mục 1
- Mục 2

Chuyển đổi thành:

html

<ul>
  <li>Mục 1</li>
  <li>Mục 2</li>
</ul>

markdown

1. Mục 1
2. Mục 2

Chuyển đổi thành:

html

<ol>
  <li>Mục 1</li>
  <li>Mục 2</li>
</ol>

Ví dụ thực tế

Danh sách mua sắm

markdown

## Danh sách mua sắm hôm nay

### Đồ dùng sinh hoạt
- [ ] Dầu gội đầu
- [ ] Kem đánh răng
- [x] Khăn mặt

### Thực phẩm
- [ ] Sữa
- [ ] Bánh mì
- [x] Trứng
- [ ] Trái cây
  - [ ] Táo
  - [x] Chuối
  - [ ] Cam

Kế hoạch học tập

markdown

## Kế hoạch học tập tháng này

1. **Tuần một**: Kiến thức cơ bản
   - [x] Đọc chương 1-3 của hướng dẫn
   - [x] Hoàn thành bài tập 1-10
   - [ ] Xem khóa học video 1-5

2. **Tuần hai**: Dự án thực hành
   - [ ] Tạo dự án đơn giản
   - [ ] Triển khai chức năng cơ bản
   - [ ] Thêm thiết kế giao diện

3. **Tuần ba**: Nội dung nâng cao
   - [ ] Học tính năng nâng cao
   - [ ] Tối ưu hiệu suất dự án
   - [ ] Viết trường hợp kiểm tra

4. **Tuần bốn**: Tổng kết ôn tập
   - [ ] Sắp xếp ghi chú học tập
   - [ ] Chuẩn bị dự án cuối kỳ
   - [ ] Ôn tập nội dung trọng điểm

Danh sách chức năng API

markdown

## Điểm cuối API

### Quản lý người dùng
1. `GET /api/users` - Lấy danh sách người dùng
   - Hỗ trợ phân trang
   - Hỗ trợ tìm kiếm lọc
   
2. `POST /api/users` - Tạo người dùng mới
   - Cần quyền quản trị viên
   - Xác minh tính duy nhất của email
   
3. `PUT /api/users/:id` - Cập nhật thông tin người dùng
   - Người dùng chỉ có thể cập nhật thông tin của mình
   - Quản trị viên có thể cập nhật bất kỳ người dùng nào

### Quản lý nội dung
- `GET /api/posts` - Lấy danh sách bài viết
- `POST /api/posts` - Tạo bài viết mới
- `DELETE /api/posts/:id` - Xóa bài viết

Cú pháp liên quan

Danh sách công việc - Chức năng công việc mở rộng
Danh sách định nghĩa - Định nghĩa thuật ngữ
Cú pháp trích dẫn - Văn bản trích dẫn
Cú pháp mã - Định dạng mã

Luyện tập

Tạo các loại danh sách sau:

Một cấu trúc dự án lồng nhau ba cấp
Một danh sách các bước kỹ thuật bao gồm ví dụ mã
Một danh sách phức tạp trộn lẫn có thứ tự và không có thứ tự
Một danh sách dự án bao gồm trạng thái công việc

Cú pháp danh sách ​

Danh sách không có thứ tự ​

Cú pháp cơ bản ​

Gợi ý chọn ký hiệu ​

Danh sách có thứ tự ​

Cú pháp cơ bản ​

Số thứ tự ​

Số bắt đầu ​

Danh sách lồng nhau ​

Lồng cơ bản ​

Lồng hỗn hợp ​

Nội dung nhiều đoạn trong danh sách ​

Đoạn tiếp theo ​

Khối mã ​

Danh sách công việc ​

Cú pháp cơ bản ​

Danh sách công việc lồng nhau ​

Lỗi thường gặp và giải pháp ​

1. Thụt lề không đúng ​

2. Dòng trống giữa các mục danh sách ​

3. Thiếu khoảng trắng sau số ​

Xử lý trường hợp đặc biệt ​

Thoát ký hiệu danh sách ​

Mã trong mục danh sách ​

Liên kết trong mục danh sách ​

Thực hành tốt nhất ​

1. Duy trì tính nhất quán ​

2. Sử dụng lồng hợp lý ​

3. Tổ chức theo ngữ nghĩa ​

Đầu ra HTML ​

Ví dụ thực tế ​

Danh sách mua sắm ​

Kế hoạch học tập ​

Danh sách chức năng API ​

Cú pháp liên quan ​

Luyện tập ​

Cú pháp danh sách

Danh sách không có thứ tự

Cú pháp cơ bản

Gợi ý chọn ký hiệu

Danh sách có thứ tự

Cú pháp cơ bản

Số thứ tự

Số bắt đầu

Danh sách lồng nhau

Lồng cơ bản

Lồng hỗn hợp

Nội dung nhiều đoạn trong danh sách

Đoạn tiếp theo

Khối mã

Danh sách công việc

Cú pháp cơ bản

Danh sách công việc lồng nhau

Lỗi thường gặp và giải pháp

1. Thụt lề không đúng

2. Dòng trống giữa các mục danh sách

3. Thiếu khoảng trắng sau số

Xử lý trường hợp đặc biệt

Thoát ký hiệu danh sách

Mã trong mục danh sách

Liên kết trong mục danh sách

Thực hành tốt nhất

1. Duy trì tính nhất quán

2. Sử dụng lồng hợp lý

3. Tổ chức theo ngữ nghĩa

Đầu ra HTML

Ví dụ thực tế

Danh sách mua sắm

Kế hoạch học tập

Danh sách chức năng API

Cú pháp liên quan

Luyện tập