Liên kết

Để tạo liên kết nội tuyến, hãy sử dụng một bộ dấu ngoặc đơn thông thường ngay sau dấu ngoặc vuông đóng của văn bản liên kết. Bên trong dấu ngoặc đơn, hãy đặt URL ở vị trí mà bạn muốn đường liên kết trỏ đến, cùng với tiêu đề tuỳ chọn cho đường liên kết, được đặt trong dấu ngoặc kép. Ví dụ:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

Sẽ sản xuất:

<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>

<p><a href="http://example.net/">This link</a> has no
title attribute.</p>

Nếu đang tham chiếu đến một tài nguyên cục bộ trên cùng một máy chủ, bạn có thể sử dụng đường dẫn tương đối:

See my [About](/about/) page for details.

Chỉ định thuộc tính HTML trong Markdown

Để thêm một hoặc nhiều thuộc tính vào đường liên kết trong Markdown, bạn có thể sử dụng định dạng được phân tách bằng dấu cách sau đây:

[link text](url){: attribute="value" attribute2="value2" attribute3="value3"}

Bạn có thể thông báo cho người đọc rằng một đường liên kết sẽ dẫn đến một trang web bên ngoài bằng cách thêm {: .external} vào cú pháp.

Liên kết kiểu tham chiếu sử dụng bộ dấu ngoặc vuông thứ hai, bên trong đó bạn đặt một nhãn tuỳ ý chọn để xác định liên kết:

This is [an example][id] reference-style link.

Bạn có thể tuỳ ý sử dụng dấu cách để phân tách các cặp dấu ngoặc đơn:

This is [an example] [id] reference-style link.

Sau đó, ở bất kỳ vị trí nào trong tài liệu, bạn đều xác định nhãn liên kết của mình như sau, trên một dòng riêng:

(Không bắt buộc) URL liên kết có thể được đặt trong dấu ngoặc nhọn:

Bạn có thể đặt thuộc tính tiêu đề trên dòng tiếp theo và sử dụng thêm dấu cách hoặc thẻ cho khoảng đệm, cách này thường trông đẹp hơn với URL dài hơn:

Tên định nghĩa về đường liên kết có thể bao gồm chữ cái, số, dấu cách và dấu câu – nhưng không phân biệt chữ hoa chữ thường. Ví dụ: hai đường liên kết sau:

[link text][a]
[link text][A]

đều tương đương.

Lối tắt tên đường liên kết ngầm ẩn cho phép bạn bỏ qua tên của đường liên kết. Trong trường hợp đó, văn bản liên kết sẽ được dùng làm tên. Chỉ cần sử dụng một cặp dấu ngoặc vuông -- ví dụ: để liên kết từ "Google" vào trang web google.com, bạn chỉ cần viết:

[Google]

Sau đó, xác định đường liên kết:

Do tên liên kết có thể chứa dấu cách, phím tắt này thậm chí hoạt động cho nhiều từ trong văn bản liên kết:

Visit [Daring Fireball] for more information.

Sau đó, xác định đường liên kết:

Bạn có thể đặt định nghĩa về đường liên kết ở bất kỳ vị trí nào trong tài liệu Markdown. Tôi thường đặt chúng ngay sau mỗi đoạn mà chúng được sử dụng, nhưng nếu muốn, bạn có thể đặt tất cả chúng ở cuối tài liệu, giống như chú thích.

Dưới đây là ví dụ về cách hoạt động của đường liên kết tham khảo:

I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].

Bằng cách sử dụng lối tắt tên đường liên kết ngầm ẩn, bạn có thể viết:

I get 10 times more traffic from [Google] than from
[Yahoo] or [MSN].

Cả hai ví dụ trên sẽ cho ra kết quả HTML sau:

<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>

Để so sánh, dưới đây là đoạn văn tương tự được viết bằng kiểu liên kết cùng dòng của Markdown:

I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").

Markdown hỗ trợ kiểu khẩu lệnh nhanh để tạo chế độ "tự động" liên kết cho URL và địa chỉ email: chỉ cần đặt URL hoặc địa chỉ email trong dấu ngoặc nhọn. Điều này có nghĩa là nếu bạn muốn hiển thị văn bản thực tế của một URL hoặc địa chỉ email, đồng thời muốn hiển thị văn bản là đường liên kết có thể nhấp vào, thì bạn có thể thực hiện như sau:

<http://example.com/>

Markdown sẽ chuyển thông tin này thành:

<a href="http://example.com/">http://example.com/</a>

Các đường liên kết tự động cho các địa chỉ email hoạt động tương tự nhau, ngoại trừ việc Markdown cũng sẽ thực hiện mã hoá thực thể thập phân và hex ngẫu nhiên để giúp che khuất địa chỉ của bạn khỏi những bot rác thu thập địa chỉ. Ví dụ: Markdown sẽ tắt tính năng này:

<address@example.com>

thành nội dung như sau:

<a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;
&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;
&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;
&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>

URL này sẽ hiển thị trong trình duyệt dưới dạng một đường liên kết có thể nhấp vào đến "address@example.com".