Khối trích dẫn Markdown: trích dẫn, nhiều đoạn văn và danh sách
Viết trích dẫn Markdown bằng >, lồng khối trích dẫn, trích dẫn nhiều đoạn văn và phân biệt cảnh báo GitHub với cú pháp tương thích rộng trước khi xuất Word.
Khối trích dẫn Markdown bắt đầu bằng > theo sau là một dấu cách. Đặt ký hiệu ở đầu mỗi dòng được trích dẫn để mã nguồn dễ đọc và chỉnh sửa.
> Hướng dẫn cài đặt đã chỉnh sửa sẵn sàng để duyệt.
Kết quả là một đoạn văn trích dẫn, không phải khối mã. Đường viền, thụt lề và màu sắc phụ thuộc vào giao diện của trang hoặc tài liệu. Văn bản trong trích dẫn vẫn là Markdown thông thường, vì vậy có thể chứa nhấn mạnh, liên kết, danh sách và các cấu trúc tài liệu khác.
Dùng trình xem Markdown để thử các ví dụ, sau đó xuất tài liệu qua trình chuyển đổi Markdown sang Word khi cần một bản có thể chỉnh sửa để duyệt.
Trích dẫn một đoạn văn trên nhiều dòng mã nguồn
Với trích dẫn dài hơn, hãy lặp lại ký hiệu:
> Hướng dẫn cài đặt đã chỉnh sửa sẵn sàng để duyệt.
> Hãy kiểm tra các điều kiện tiên quyết trước khi phê duyệt bản phát hành.
Hai dòng mã nguồn này tạo thành một đoạn văn trong bản xem trước của trang này. Ký tự xuống dòng trong nguồn không nhất thiết buộc nội dung hiển thị xuống dòng. Khi câu chữ phải giữ nguyên trên hai dòng, hãy thêm ngắt dòng rõ ràng:
> Duyệt tài liệu\
> Được giao cho người quản lý phát hành
Dấu gạch chéo ngược nằm trước ký tự xuống dòng; dòng tiếp theo vẫn bắt đầu bằng ký hiệu trích dẫn. Xem xuống dòng trong Markdown để biết sự khác biệt giữa ngắt dòng bắt buộc và ngắt đoạn văn.
Đưa nhiều đoạn văn vào cùng một trích dẫn
Đặt ký hiệu trích dẫn trên dòng vốn để trống giữa các đoạn văn:
> Bản nháp đầu tiên mô tả quy trình cài đặt.
>
> Bản nháp thứ hai bổ sung các bước xử lý sự cố và ví dụ.
Cách này tạo ra một khối trích dẫn chứa hai đoạn văn. Giữ > trên dòng phân cách giúp thể hiện rõ ý định nhóm nội dung, đặc biệt khi người khác chỉnh sửa đoạn đó về sau.
Để tiếp tục văn bản của riêng bạn, hãy chừa một dòng trống rồi viết tiếp mà không có ký hiệu:
> Ý kiến duyệt yêu cầu rút gọn phần cài đặt.
Chúng tôi đã chuyển ghi chú cấu hình chi tiết vào phụ lục.
Tránh bỏ > khỏi một dòng tiếp nối mà không thêm dòng trống. Một số bộ phân tích Markdown xem đó là phần tiếp nối ngầm của đoạn trích dẫn. Đặc tả khối trích dẫn CommonMark mô tả hành vi này. Ký hiệu rõ ràng và dòng trống phân tách giúp người cộng tác dễ bảo trì hơn.
Thêm nhấn mạnh, liên kết và nguồn trích dẫn
Nội dung khối trích dẫn có thể dùng định dạng nội dòng thông thường:
> **Ghi chú duyệt:** Các bước di chuyển cần một ví dụ hoạt động được.
> Xem [danh sách kiểm tra phát hành](https://example.com/checklist).
>
> Phản hồi từ đợt duyệt tài liệu, tháng 9 năm 2026.
Markdown không gán vai trò dẫn nguồn đặc biệt cho dòng cuối. Đây là nội dung đoạn văn thông thường trong trích dẫn. Hãy bổ sung nguồn, tác giả và liên kết khi cần, đồng thời xác minh quyền sử dụng trước khi sao chép đoạn văn của người khác.
Khối trích dẫn cũng không tự thêm dấu ngoặc kép thực tế. Hãy tự nhập nếu tài liệu cuối cùng yêu cầu. Với một trích dẫn ngắn được lồng vào câu của bạn, dấu ngoặc kép thông thường có thể đã đủ mà không cần tạo một khối riêng.
Lồng trích dẫn hoặc thêm danh sách
Dùng thêm một cấp > cho nội dung được trích dẫn bên trong trích dẫn bên ngoài:
> Người duyệt tóm tắt yêu cầu trước đó:
>
> > Thêm một ví dụ đầy đủ về tệp cấu hình.
>
> Bản nháp đã cập nhật hiện có ví dụ đó.
Hãy hạn chế số cấp lồng trong báo cáo. Trích dẫn lồng quá sâu làm giảm chiều rộng dành cho văn bản, có thể khiến bố cục PDF và Word khó đọc hơn.
Danh sách bên trong trích dẫn giữ ký hiệu trên mọi dòng:
> Đợt duyệt xác định hai thay đổi:
>
> - Giải thích các quyền cần thiết.
> - Thêm phần xử lý sự cố.
Với cấu trúc ngược lại, tức trích dẫn bên trong danh sách, hãy thụt lề nó bên dưới văn bản của mục danh sách:
- Phản hồi về tài liệu
> Thêm phần xử lý sự cố trước khi xuất bản.
- Danh sách kiểm tra phát hành
Nếu trích dẫn xuất hiện bên ngoài mục, hãy so sánh thụt lề với các ví dụ trong hướng dẫn thụt lề Markdown.
Cảnh báo GitHub cần nơi xuất bản hỗ trợ
GitHub hỗ trợ các cảnh báo đặc biệt được xây dựng trên cú pháp trích dẫn, bao gồm dạng này:
> [!NOTE]
> Sao lưu cấu hình trước khi thay đổi.
GitHub mô tả những loại được hỗ trợ trong tài liệu tham khảo về cảnh báo. Màu sắc và biểu tượng cảnh báo là tính năng của nền tảng, không phải thuộc tính của mọi trích dẫn Markdown.
Bộ kết xuất của trang này không thêm kiểu cảnh báo của GitHub. Ví dụ vẫn là khối trích dẫn với nhãn [!NOTE] hiển thị rõ. Với tài liệu cần đọc dễ dàng ở nhiều nơi xuất bản, hãy dùng nhãn in đậm tường minh:
> **Lưu ý:** Sao lưu cấu hình trước khi thay đổi.
Cách này giữ ý nghĩa dễ hiểu mà không cần phần mở rộng cảnh báo đặc biệt. Cũng có thể áp dụng cho cảnh báo, quyết định duyệt hoặc ghi chú biên tập.
Xử lý vấn đề trích dẫn trước khi xuất
Nếu > hiển thị nguyên dạng, hãy kiểm tra xem ví dụ có nằm trong dấu nháy ngược, khối mã có hàng rào hay khối mã thụt lề hay không. Những ngữ cảnh đó vốn dùng để hiển thị văn bản nguồn. Dấu gạch chéo ngược trước ký hiệu cũng khiến ký hiệu được hiển thị theo nghĩa đen.
Nếu quá nhiều văn bản trở thành trích dẫn, hãy thêm dòng trống trước đoạn cần trở lại bên ngoài trích dẫn. Nếu nội dung lồng nhau khó theo dõi, hãy giảm cấp lồng và thêm nguồn dưới dạng đoạn văn thông thường.
Cuối cùng, mở DOCX đã xuất và kiểm tra các trích dẫn dài cùng danh sách trong trích dẫn. Đường viền bên trái của trình duyệt và kiểu đoạn văn của tài liệu Word có thể khác nhau. Dùng công cụ Markdown sang HTML để kiểm tra cấu trúc trung gian khi cần phân biệt vấn đề định dạng nguồn với vấn đề kiểu trình bày lúc xuất.