Cú pháp trích dẫn

Trích dẫn (Blockquote) dùng để làm nổi bật đoạn văn được trích hoặc nhấn mạnh thông tin quan trọng. Trong Markdown, sử dụng ký hiệu > ở đầu dòng để tạo khối trích dẫn.

Cú pháp cơ bản

Trích dẫn một dòng

Dùng ký hiệu > ở đầu dòng để tạo trích dẫn:

markdown

> Đây là một khối trích dẫn.

Kết quả hiển thị:

Đây là một khối trích dẫn.

Trích dẫn nhiều dòng

markdown

> Đây là dòng thứ nhất của trích dẫn.
> Đây là dòng thứ hai của trích dẫn.
> Đây là dòng thứ ba của trích dẫn.

Kết quả hiển thị:

Đây là dòng thứ nhất của trích dẫn. Đây là dòng thứ hai của trích dẫn. Đây là dòng thứ ba của trích dẫn.

Trích dẫn nhiều đoạn

Bao gồm nhiều đoạn trong trích dẫn:

markdown

> Đây là đoạn thứ nhất của trích dẫn.
>
> Đây là đoạn thứ hai của trích dẫn.

Kết quả hiển thị:

Đây là đoạn thứ nhất của trích dẫn.
Đây là đoạn thứ hai của trích dẫn.

Trích dẫn lồng nhau

Lồng cơ bản

Dùng >> để tạo trích dẫn lồng nhau:

markdown

> Đây là trích dẫn cấp 1.
>
> > Đây là trích dẫn cấp 2.
>
> Quay lại trích dẫn cấp 1.

Kết quả hiển thị:

Đây là trích dẫn cấp 1.
Đây là trích dẫn cấp 2.
Quay lại trích dẫn cấp 1.

Lồng nhiều cấp

markdown

> Cấp 1
> > Cấp 2
> > > Cấp 3
> > > > Cấp 4
> >
> > Quay lại cấp 2
>
> Quay lại cấp 1

Kết quả hiển thị:

Cấp 1
Cấp 2
Cấp 3
Cấp 4
Quay lại cấp 2
Quay lại cấp 1

Các phần tử khác bên trong trích dẫn

Định dạng trong trích dẫn

markdown

> **Chữ đậm** và *chữ nghiêng* hoạt động bình thường trong trích dẫn.
> 
> Bạn có thể dùng `mã nội tuyến` và các định dạng khác.

Kết quả hiển thị:

Chữ đậm và chữ nghiêng hoạt động bình thường trong trích dẫn.
Bạn có thể dùng mã nội tuyến và các định dạng khác.

Tiêu đề trong trích dẫn

markdown

> ## Tiêu đề trong trích dẫn
> 
> Đây là nội dung chính trong trích dẫn.
> 
> ### Tiêu đề phụ
> 
> Thêm nội dung trích dẫn.

Kết quả hiển thị:

Tiêu đề trong trích dẫn
Đây là nội dung chính trong trích dẫn.
Tiêu đề phụ
Thêm nội dung trích dẫn.

Danh sách trong trích dẫn

markdown

> Danh sách trong trích dẫn:
> 
> 1. Mục thứ nhất
> 2. Mục thứ hai
> 3. Mục thứ ba
> 
> Hoặc danh sách không thứ tự:
> 
> - Mục A
> - Mục B
> - Mục C

Kết quả hiển thị:

Danh sách trong trích dẫn:
Mục thứ nhất
Mục thứ hai
Mục thứ ba
Hoặc danh sách không thứ tự:
Mục A
Mục B
Mục C

Khối mã trong trích dẫn

markdown

> Ví dụ mã nguồn:
> 
> ```javascript
> function hello() {
>   console.log("Hello, World!");
> }
> ```
> 
> Khối mã cũng hiển thị bình thường trong trích dẫn.

Kết quả hiển thị:

Ví dụ mã nguồn:
javascript
function hello() {
  console.log("Hello, World!");
}
Khối mã cũng hiển thị bình thường trong trích dẫn.

Liên kết trong trích dẫn

markdown

> Xem [tài liệu chính thức](https://www.markdownlang.com) để biết thêm thông tin.
> 
> Bạn cũng có thể truy cập trực tiếp <https://www.markdownlang.com>.

Kết quả hiển thị:

Xem tài liệu chính thức để biết thêm thông tin.
Bạn cũng có thể truy cập trực tiếp https://www.markdownlang.com.

Tình huống sử dụng thường gặp

1. Trích dẫn tài liệu

markdown

> "Markdown là một ngôn ngữ đánh dấu nhẹ, cho phép soạn thảo tài liệu bằng văn bản thuần dễ đọc, dễ viết."
> 
> —— John Gruber, người tạo ra Markdown

Kết quả hiển thị:

"Markdown là một ngôn ngữ đánh dấu nhẹ, cho phép soạn thảo tài liệu bằng văn bản thuần dễ đọc, dễ viết."
—— John Gruber, người tạo ra Markdown

2. Cảnh báo

markdown

> ⚠️ **Cảnh báo**
> 
> Thao tác này sẽ xóa toàn bộ dữ liệu, hãy đảm bảo đã sao lưu các tệp quan trọng.

Kết quả hiển thị:

⚠️ Cảnh báo
Thao tác này sẽ xóa toàn bộ dữ liệu, hãy đảm bảo đã sao lưu các tệp quan trọng.

3. Gợi ý

markdown

> 💡 **Gợi ý**
> 
> Sử dụng phím tắt `Ctrl+S` để lưu tài liệu nhanh.

Kết quả hiển thị:

💡 Gợi ý
Sử dụng phím tắt Ctrl+S để lưu tài liệu nhanh.

4. Lưu ý quan trọng

markdown

> 📌 **Lưu ý quan trọng**
> 
> Trước khi bắt đầu, hãy đảm bảo bạn đã cài các phụ thuộc sau:
> 
> - Node.js (>= 14.0)
> - npm (>= 6.0)
> - Git

Kết quả hiển thị:

📌 Lưu ý quan trọng
Trước khi bắt đầu, hãy đảm bảo bạn đã cài các phụ thuộc sau:
Node.js (>= 14.0)
npm (>= 6.0)
Git

Lỗi thường gặp và cách khắc phục

1. Bỏ sót ký hiệu >

markdown

❌ Sai:
> Dòng 1 của trích dẫn
Dòng 2 quên ký hiệu >  ← Dòng này sẽ không nằm trong trích dẫn

✅ Đúng:
> Dòng 1 của trích dẫn
> Dòng 2 của trích dẫn (đầy đủ ký hiệu)

2. Lỗi cấp độ lồng nhau

markdown

❌ Sai:
> Cấp 1
> > > Nhảy thẳng đến cấp 3  ← Bỏ qua cấp 2

✅ Đúng:
> Cấp 1
> > Cấp 2
> > > Cấp 3

3. Xử lý dòng trống

markdown

❌ Có thể gây vấn đề:
> Đoạn 1

> Đoạn 2  ← Sẽ tạo hai khối trích dẫn tách biệt

✅ Cách đúng để trích dẫn nhiều đoạn:
> Đoạn 1
>
> Đoạn 2

Thực hành tốt

1. Giữ phong cách nhất quán

markdown

✅ Khuyến nghị: Phong cách trích dẫn nhất quán
> Dùng khối trích dẫn cho thông tin quan trọng
> Giữ định dạng thống nhất

❌ Không khuyến nghị: Trộn lẫn cách trình bày
> Lúc thì dùng trích dẫn
**Lúc lại dùng chữ đậm thay thế**

2. Lồng ở mức vừa phải

markdown

✅ Khuyến nghị: Lồng đơn giản, rõ ràng
> Luận điểm chính
> > Luận cứ hỗ trợ
> 
> Tiếp tục luận điểm chính

❌ Không khuyến nghị: Lồng quá sâu
> > > > > Quá sâu, khó đọc

3. Dùng đúng ngữ nghĩa

markdown

✅ Khuyến nghị: Trích dẫn có ý nghĩa
> Đây là thông tin quan trọng từ tài liệu uy tín

❌ Không khuyến nghị: Trích dẫn chỉ để trang trí
> Đây chỉ là văn bản thường, không cần định dạng trích dẫn

Đầu ra HTML

Trích dẫn trong Markdown chuyển sang HTML:

markdown

> Đây là đoạn văn được trích

Chuyển thành:

html

<blockquote>
  <p>Đây là đoạn văn được trích</p>
</blockquote>

Trích dẫn lồng nhau:

markdown

> Cấp 1
> > Cấp 2

Chuyển thành:

html

<blockquote>
  <p>Cấp 1</p>
  <blockquote>
    <p>Cấp 2</p>
  </blockquote>
</blockquote>

Tùy biến kiểu dáng

Một số bộ xử lý Markdown hỗ trợ tùy biến kiểu trích dẫn:

Hộp nhắc kiểu GitHub

markdown

> [!NOTE]
> Đây là một thông tin nhắc

> [!WARNING]
> Đây là một cảnh báo

> [!IMPORTANT]
> Đây là một nhắc quan trọng

Dùng HTML và CSS

markdown

<blockquote style="border-left: 4px solid #3498db; padding-left: 1em; color: #7f8c8d;">
Đây là một khối trích dẫn với kiểu dáng tùy chỉnh
</blockquote>

Ví dụ thực tiễn

Ví dụ trong tài liệu API

markdown

## Xác thực người dùng

Xác thực người dùng là bước cần thiết để truy cập API.

> **Cách xác thực**
> 
> API của chúng tôi sử dụng Bearer Token để xác thực:
> 
> ```bash
> curl -H "Authorization: Bearer YOUR_TOKEN" \
>      https://api.example.com/users
> ```

### Ví dụ yêu cầu

Gửi yêu cầu POST để tạo người dùng:

> ```json
> {
>   "name": "Zhang San",
>   "email": "zhangsan@example.com",
>   "role": "user"
> }
> ```

Lưu ý trong hướng dẫn

markdown

## Các bước cài đặt

1. Tải trình cài đặt
2. Chạy trình cài đặt

> ⚠️ **Lưu ý**
> 
> Trước khi cài đặt, hãy đảm bảo:
> - Tắt phần mềm diệt virus
> - Chạy với quyền quản trị viên
> - Ổ đĩa hệ thống còn ít nhất 2GB trống

3. Hoàn tất cài đặt theo trình hướng dẫn

Cú pháp liên quan

Cú pháp nhấn mạnh - Định dạng văn bản
Cú pháp danh sách - Danh sách mục
Cú pháp mã - Định dạng mã nguồn
Cú pháp liên kết - Tạo liên kết

Bài tập

Hãy thử tạo các nội dung sau:

Một khối trích dẫn chứa nhiều đoạn
Một cấu trúc trích dẫn lồng 3 cấp
Một trích dẫn trong tài liệu kỹ thuật có kèm ví dụ mã
Một trích dẫn lồng nhau mô phỏng hội thoại

Cú pháp trích dẫn ​

Cú pháp cơ bản ​

Trích dẫn một dòng ​

Trích dẫn nhiều dòng ​

Trích dẫn nhiều đoạn ​

Trích dẫn lồng nhau ​

Lồng cơ bản ​

Lồng nhiều cấp ​

Các phần tử khác bên trong trích dẫn ​

Định dạng trong trích dẫn ​

Tiêu đề trong trích dẫn ​

Tiêu đề trong trích dẫn ​

Tiêu đề phụ ​

Danh sách trong trích dẫn ​

Khối mã trong trích dẫn ​

Liên kết trong trích dẫn ​

Tình huống sử dụng thường gặp ​

1. Trích dẫn tài liệu ​

2. Cảnh báo ​

3. Gợi ý ​

4. Lưu ý quan trọng ​

Lỗi thường gặp và cách khắc phục ​

1. Bỏ sót ký hiệu > ​

2. Lỗi cấp độ lồng nhau ​

3. Xử lý dòng trống ​

Thực hành tốt ​

1. Giữ phong cách nhất quán ​

2. Lồng ở mức vừa phải ​

3. Dùng đúng ngữ nghĩa ​

Đầu ra HTML ​

Tùy biến kiểu dáng ​

Hộp nhắc kiểu GitHub ​

Dùng HTML và CSS ​

Ví dụ thực tiễn ​

Ví dụ trong tài liệu API ​

Lưu ý trong hướng dẫn ​

Cú pháp liên quan ​

Bài tập ​

Cú pháp trích dẫn

Cú pháp cơ bản

Trích dẫn một dòng

Trích dẫn nhiều dòng

Trích dẫn nhiều đoạn

Trích dẫn lồng nhau

Lồng cơ bản

Lồng nhiều cấp

Các phần tử khác bên trong trích dẫn

Định dạng trong trích dẫn

Tiêu đề trong trích dẫn

Tiêu đề trong trích dẫn

Tiêu đề phụ

Danh sách trong trích dẫn

Khối mã trong trích dẫn

Liên kết trong trích dẫn

Tình huống sử dụng thường gặp

1. Trích dẫn tài liệu

2. Cảnh báo

3. Gợi ý

4. Lưu ý quan trọng

Lỗi thường gặp và cách khắc phục

1. Bỏ sót ký hiệu >

2. Lỗi cấp độ lồng nhau

3. Xử lý dòng trống

Thực hành tốt

1. Giữ phong cách nhất quán

2. Lồng ở mức vừa phải

3. Dùng đúng ngữ nghĩa

Đầu ra HTML

Tùy biến kiểu dáng

Hộp nhắc kiểu GitHub

Dùng HTML và CSS

Ví dụ thực tiễn

Ví dụ trong tài liệu API

Lưu ý trong hướng dẫn

Cú pháp liên quan

Bài tập