Gạch dưới trong Markdown: cách hoạt động trên GitHub và trình hiển thị khác

Markdown không có cú pháp nguyên bản để gạch dưới văn bản. Trong CommonMark và GitHub Flavored Markdown, _văn bản_ là chữ nghiêng và __văn bản__ là chữ đậm. Gạch dưới thường cần hỗ trợ HTML hoặc phần mở rộng riêng của ứng dụng.

Dạng được GitHub ghi trong tài liệu là:

<ins>Hạn chót đã sửa</ins> là thứ Sáu.

GitHub liệt kê <ins>...</ins> cho văn bản gạch dưới trong tài liệu định dạng cơ bản. Đây là lựa chọn HTML mà nền tảng hỗ trợ, không phải dấu phân định Markdown mới dùng được ở mọi nơi.

So sánh gạch dưới, chữ đậm và chữ nghiêng

Mã nguồn	Ý nghĩa	Nơi hỗ trợ
_quan trọng_	Nhấn mạnh, thường là chữ nghiêng	CommonMark và GFM
__quan trọng__	Nhấn mạnh mạnh, thường là chữ đậm	CommonMark và GFM
**quan trọng**	Nhấn mạnh mạnh, thường là chữ đậm	CommonMark và GFM
<ins>văn bản thêm</ins>	Văn bản được chèn, thường gạch dưới	Trình hiển thị cho phép HTML; có trong tài liệu GitHub
<u>văn bản chú thích</u>	Chú thích HTML, thường gạch dưới	Trình hiển thị cho phép phần tử HTML này

Chọn chữ đậm hoặc chữ nghiêng nếu mục đích là nhấn mạnh. Ví dụ, **Hạn thứ Sáu** dùng được trong README, ghi chú và bản xuất Markdown mà không phụ thuộc HTML thô.

ins và u khác nhau thế nào?

Hai thẻ có thể trông giống nhau nhưng mang ý nghĩa khác nhau.

<ins> biểu diễn văn bản được chèn vào tài liệu. Nó phù hợp với một sửa đổi như thêm yêu cầu mới. Trình duyệt thường gạch dưới, nhưng bảng định kiểu có thể đổi cách hiển thị. Xem tham khảo văn bản được chèn của MDN.

Bản phát hành hỗ trợ <ins>nhập CSV và TSV</ins>.

<u> đánh dấu chú thích không phải nhấn mạnh thông thường, chẳng hạn chỉ ra lỗi chính tả. HTML hiện đại không định nghĩa nó là thẻ chung để “làm nổi bật mức quan trọng”. Xem tham khảo phần tử u của MDN.

Hãy kiểm tra chính tả của <u>recieve</u>.

Nếu bạn quản lý trang web và chỉ cần gạch dưới về mặt hình thức, áp dụng text-decoration: underline qua CSS. Nền tảng Markdown được lưu trữ có thể xóa thuộc tính kiểu hoặc không cho phép kiểu tùy chỉnh, nên cách này cũng không luôn dùng được ở mọi nơi.

Vì sao gạch dưới hoạt động trong trình sửa này nhưng biến mất trong trình sửa khác?

Có ba quyết định riêng biệt: bộ phân tích Markdown nhận diện HTML, ứng dụng chọn thẻ nào được phép, và bảng định kiểu đích quyết định cách hiển thị phần tử được chấp nhận. Hỗ trợ GFM không đảm bảo sản phẩm cho phép mọi thẻ HTML.

Trình soạn thảo MD File Viewer hiện bỏ thẻ HTML thô khỏi đầu vào của người dùng. Dán <ins>văn bản thêm</ins> hoặc <u>văn bản chú thích</u> sẽ giữ chữ nhưng bỏ thẻ, nên bản xem trước không gạch dưới. Dùng bản xem trước để kiểm tra định dạng Markdown được hỗ trợ và xác minh định dạng HTML tại nơi sẽ đăng tài liệu.

Nếu chuyển tài liệu HTML sang Markdown, bộ chuyển HTML sang Markdown giúp khôi phục văn bản, tiêu đề, liên kết và danh sách. Gạch dưới và CSS tùy chỉnh có thể mất vì Markdown thường không có cú pháp tương ứng. Kiểm tra kết quả trước khi thay tài liệu gốc.

Ví dụ GitHub README

Với phần bổ sung ngắn trong ghi chú thay đổi, tùy chọn HTML mà GitHub ghi nhận là:

Phiên bản này thêm <ins>một bước nhập tùy chọn</ins>.

Với hạn chót hoặc yêu cầu, dùng nhấn mạnh Markdown:

**Bắt buộc:** Thêm hàng tiêu đề vào tệp CSV.

Với đích đến, dùng liên kết:

[Đọc hướng dẫn nhập](https://example.com/import)

Văn bản gạch dưới có thể trông giống liên kết có thể nhấp. Tránh làm nhãn thông thường có vẻ tương tác được, nhất là khi cùng đoạn có liên kết thật. Hướng dẫn liên kết Markdown trình bày văn bản liên kết mô tả và liên kết tham chiếu.

Lỗi gạch dưới thường gặp

Hai dấu gạch dưới làm chữ đậm. Đổi **từ** thành __từ__ chỉ đổi dấu phân định, không đổi ý nghĩa. Cả hai đều biểu diễn nhấn mạnh mạnh.

Dấu nháy ngược hiển thị thẻ như mã. Viết `<ins>văn bản</ins>` hữu ích trong hướng dẫn, nhưng cố ý cho thấy mã đánh dấu thay vì áp dụng nó.

Phím tắt thuộc về ứng dụng. Trình sửa văn bản có định dạng có thể cung cấp lệnh gạch dưới và lưu HTML hoặc định dạng riêng. Điều đó không biến gạch dưới thành một phần Markdown tương thích đa nền tảng.

Tiêu đề kiểu gạch dưới là khái niệm khác. Trong mã nguồn này, các dấu gạch nối tạo tiêu đề cấp hai:

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

Chúng không gạch dưới một cụm từ trong đoạn văn. Để chia các phần, dùng đường kẻ ngang Markdown với dòng trống xung quanh.

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

Làm sao gạch dưới trong Markdown trên GitHub?

Dùng <ins>văn bản</ins>, cách GitHub ghi nhận để gạch dưới. Nếu cần nhấn mạnh cả trong trình hiển thị không hỗ trợ HTML, dùng **văn bản** hoặc *văn bản* thay thế.

Có cách gạch dưới chỉ bằng Markdown không?

Không có dấu phân định gạch dưới tiêu chuẩn. Một số ứng dụng thêm cú pháp riêng, nhưng bạn phải kiểm tra tài liệu và định dạng dùng khi xuất.

Gạch dưới có được giữ khi chuyển Markdown sang PDF hoặc Word không?

Chỉ khi công cụ chuyển đổi giữ lại HTML hoặc phần mở rộng liên quan và hỗ trợ kiểu của nó. Đừng cho rằng gạch dưới thấy trong bản xem trước của một ứng dụng sẽ còn trong bản xuất bằng công cụ khác. Kiểm tra tệp kết quả hoặc dùng chữ đậm tiêu chuẩn khi tính tương thích là ưu tiên.

Bảng tra cứu Markdown là tài liệu tham khảo ngắn về định dạng có cú pháp Markdown riêng.