Trình tạo liên kết Markdown

Bốn biến thể liên kết

Nội tuyến, không tiêu đề:

[Đọc tài liệu](https://example.com/docs)

Nội tuyến kèm tiêu đề (chú thích khi di chuột lên):

[Đọc tài liệu](https://example.com/docs "Tài liệu đầy đủ")

Kiểu tham chiếu (URL được định nghĩa bên dưới):

Mở [tài liệu][docs] hoặc [nhật ký thay đổi][cl].

[docs]: https://example.com/docs
[cl]:   https://example.com/changelog

Liên kết tự động (URL vừa là văn bản vừa là đích đến):

<https://example.com>

Khi nào nên chọn kiểu nào

• Nội tuyến: dùng cho những liên kết thỉnh thoảng, khi URL ngắn và đoạn văn vẫn dễ đọc.
• Kiểu tham chiếu: khi bạn trích dẫn cùng một URL nhiều lần, hoặc khi URL là một chuỗi theo dõi khổng lồ dài 200 ký tự mà nếu để nguyên sẽ làm gián đoạn mạch đoạn văn.
• Liên kết tự động: dùng cho trường hợp như “đây là trang tài liệu của chúng tôi”, khi bạn thực sự muốn URL hiển thị vừa là văn bản vừa là đích đến.

Xử lý ký tự đặc biệt

• Khoảng trắng trong URL cần %20, nếu không liên kết sẽ đứt tại khoảng trắng.
• Dấu ngoặc đơn trong URL cần được mã hóa URL thành %28 và %29, nếu không trình phân tích Markdown sẽ nuốt mất chúng.
• Dấu ngoặc vuông trong văn bản liên kết phải được thoát thành \[ và \] để tránh trình phân tích hiểu nhầm chúng là cú pháp liên kết lồng nhau.

Mẹo về khả năng tiếp cận

• Tránh dùng “nhấp vào đây”. Văn bản liên kết như nhấp vào đây hoặc đọc thêm là vô dụng khi người dùng trình đọc màn hình lướt qua các liên kết bằng phím Tab. Hãy dùng văn bản mô tả: [hướng dẫn cài đặt](...).
• Đừng đặt chính URL làm văn bản liên kết cho những URL dài, điều này bất lợi cho công nghệ hỗ trợ và trông xấu khi in ra.
• “Mở trong tab mới” là HTML thô (target="_blank"), không phải Markdown. Hầu hết trình kết xuất chấp nhận HTML thô sẽ tôn trọng nó; còn CommonMark thuần túy thì không.

Lối tắt một dòng

Trong phần bình luận của GitHub, dán một URL bên cạnh văn bản đã chọn sẽ tự động chuyển nó thành liên kết Markdown. Tiện lợi khi bạn đã ở sẵn trong trình soạn thảo.