Đường kẻ ngang Markdown: dấu phân cách, quy tắc và cách sửa lỗi

Để thêm đường kẻ ngang trong Markdown, hãy đặt ba dấu gạch nối trên một dòng riêng, với dòng trống ở trên và dưới:

Kết thúc phần thứ nhất.

---

Bắt đầu phần tiếp theo.

Kết quả là một đường phân cách giữa hai đoạn văn. Markdown gọi đó là dấu ngắt chủ đề; HTML biểu diễn bằng <hr>. Dán ví dụ vào trình xem Markdown để kiểm tra tài liệu sau khi hiển thị.

Ba cách viết đường phân cách

Các dạng sau đều tạo dấu ngắt chủ đề:

Mã nguồn Markdown	Kết quả
---	Đường kẻ ngang
***	Đường kẻ ngang
___	Đường kẻ ngang
* * *	Đường kẻ ngang

Sử dụng ít nhất ba dấu gạch nối, dấu sao hoặc gạch dưới cùng loại. Có thể đặt khoảng trắng giữa các dấu. Trộn loại dấu, thêm văn bản trên cùng dòng hoặc chỉ dùng hai dấu sẽ không tạo đường kẻ. Đây là quy tắc trong đặc tả ngắt chủ đề của CommonMark.

Số dấu gạch nối không điều khiển chiều rộng hiển thị. Một dòng gồm 20 dấu và một dòng gồm ba dấu đều tạo cùng phần tử HTML; kiểu trình bày của nơi đích quyết định diện mạo.

Vì sao đường kẻ ngang biến thành tiêu đề?

Mã nguồn này không đặt đường phân cách bên dưới “Ghi chú phát hành”:

Ghi chú phát hành
---

Nó tạo tiêu đề cấp hai. Các dấu gạch nối ngay dưới đoạn văn có thể tạo tiêu đề Setext, và cách hiểu này được ưu tiên hơn đường kẻ ngang. Thêm dòng trống để tách chúng:

Ghi chú phát hành

---

Với một phần tài liệu, tiêu đề viết rõ ràng thường dễ hiểu hơn:

## Ghi chú phát hành

Quy trình nhập hiện chấp nhận tệp CSV.

Dùng tiêu đề Markdown để đặt tên phần. Dùng đường kẻ ngang khi chính sự chuyển tiếp có ý nghĩa, chẳng hạn phân tách thư và phụ lục.

Vì sao đường phân cách hiển thị thành văn bản thường?

Kiểm tra mã nguồn quanh đường kẻ:

Dấu hiệu	Nguyên nhân có thể	Cách sửa
Bản xem trước hiện --- trong khối mã	Bốn khoảng trắng ở đầu khối riêng hoặc hàng rào mã chưa đóng	Bỏ thụt lề hoặc đóng hàng rào mã
Bản xem trước hiện --	Chỉ có hai dấu gạch nối	Dùng ba dấu trở lên
Có văn bản bên cạnh dấu	Dòng chứa văn bản khác	Đặt dấu trên dòng riêng
--- hiện trong câu	Các dấu nằm trong dấu nháy ngược	Bỏ dấu nháy ngược nếu muốn tạo đường phân cách
Đoạn trước biến thành tiêu đề	Không có dòng trống trên ---	Thêm dòng trống

Ở cấp ngoài cùng của tài liệu, dấu ngắt chủ đề cho phép tối đa ba khoảng trắng đầu dòng. Trong danh sách, thụt lề còn xác định nội dung thuộc mục nào, nên hãy kiểm tra danh sách xung quanh thay vì xóa mọi khoảng trắng.

Đường kẻ ngang khác với ngắt dòng

Đường phân cách chia các phần. Nó không chỉ chuyển những từ tiếp theo xuống dòng mới.

Với địa chỉ, dùng ngắt dòng cứng:

120 phố Market\
San Francisco, California

Để tạo đoạn mới, chừa một dòng trống. Để chia phần, dùng --- trên dòng riêng. Hướng dẫn ngắt dòng Markdown giải thích khoảng trắng cuối dòng, dấu gạch chéo ngược và cách GitHub xử lý xuống dòng khác nhau trong tệp và bình luận.

Đặt đường phân cách trong trích dẫn

Giữ tiền tố > ở mọi dòng, kể cả dòng phân cách và dòng trống:

> Đề xuất ban đầu.
>
> ---
>
> Bối cảnh bổ sung từ người đánh giá.

Đường phân cách sẽ ở trong trích dẫn. Xóa > khỏi đường kẻ có thể kết thúc trích dẫn và chuyển đường phân cách ra cấp ngoài của tài liệu. Xem ví dụ trích dẫn về nhiều đoạn và trích dẫn lồng nhau.

Hàng phân cách bảng không phải đường kẻ ngang

Dòng này thuộc về bảng:

| Định dạng | Có thể sửa |
| --- | :---: |
| Markdown | Có |

Dấu gạch đứng và dấu hai chấm tùy chọn mô tả các cột. Chúng không chèn đường phân cách ngang toàn trang. Dùng trình tạo bảng Markdown để tạo bảng hoặc bộ chuyển CSV sang Markdown khi dữ liệu đã có trong bảng tính.

Đường kẻ ngang và tài liệu xuất ra

Dấu ngắt chủ đề không phải lệnh ngắt trang. Công cụ xuất PDF hoặc Word quyết định nơi kết thúc trang dựa trên bố cục và quy tắc phân trang. Đừng thêm dấu gạch nối với kỳ vọng phần tiếp theo sẽ bắt đầu trên trang mới.

Với trang web mà bạn quản lý CSS, có thể định dạng <hr> được tạo trong bảng định kiểu của trang. Dịch vụ Markdown được lưu trữ có thể không cho phép CSS tùy chỉnh. Hãy kiểm tra nơi đích hoặc tài liệu xuất ra, đặc biệt nếu ý nghĩa của đường phân cách cần được giữ sau khi in.

Câu hỏi thường gặp

Có cần dòng trống quanh đường kẻ ngang không?

CommonMark không yêu cầu trong mọi ngữ cảnh, nhưng dùng dòng trống giúp tránh nhầm --- thành tiêu đề và làm mã nguồn dễ đọc hơn.

Có thể dùng thẻ hr của HTML không?

<hr> hoạt động trong trình hiển thị cho phép HTML thô. --- phù hợp hơn cho tài liệu Markdown. Trình soạn thảo MD File Viewer bỏ thẻ HTML do người dùng nhập, nhưng hiển thị cú pháp đường phân cách Markdown bình thường.

Làm sao hiển thị ba dấu gạch nối mà không tạo đường phân cách?

Với ví dụ cú pháp, viết mã nội tuyến: `---`. Với văn bản thường trên dòng riêng, thêm ký tự thoát trước dấu gạch nối đầu tiên: \---.

Với các cách định dạng thông dụng khác, hãy tham khảo bảng tra cứu Markdown.