Cú pháp liên kết

Liên kết là phần tử quan trọng kết nối nội dung trong Markdown. Nắm vững các cú pháp liên kết khác nhau có thể làm cho tài liệu của bạn có tính kết nối và thực tế hơn.

Cú pháp liên kết cơ bản

Liên kết nội tuyến

Sử dụng định dạng [văn bản liên kết](URL) để tạo liên kết:

Đây là liên kết tới [Google](https://www.google.com).
Truy cập [GitHub](https://github.com) để xem các dự án mã nguồn mở.

Hiệu ứng kết xuất:

Đây là liên kết tới Google. Truy cập GitHub để xem các dự án mã nguồn mở.

Liên kết có tiêu đề

Thêm tiêu đề sau URL, sẽ hiển thị khi di chuột:

Đây là [liên kết có tiêu đề](https://www.example.com "Đây là tiêu đề liên kết").

Hiệu ứng kết xuất:

Đây là liên kết có tiêu đề.

Liên kết tham chiếu

Liên kết tham chiếu cơ bản

Tách định nghĩa liên kết khỏi việc sử dụng:

Đây là [liên kết tham chiếu][1].
Đây là [liên kết tham chiếu khác][link-name].

[1]: https://www.example.com
[link-name]: https://www.google.com "Tìm kiếm Google"

Hiệu ứng kết xuất:

Đây là liên kết tham chiếu. Đây là liên kết tham chiếu khác.

Nhãn liên kết ngầm định

Văn bản liên kết tự làm nhãn:

Truy cập [Google][] để tìm kiếm.
Xem các dự án trên [GitHub][].

[Google]: https://www.google.com
[GitHub]: https://github.com

Hiệu ứng kết xuất:

Truy cập Google để tìm kiếm. Xem các dự án trên GitHub.

Liên kết tự động

Liên kết URL tự động

Nhập trực tiếp URL, bao quanh bằng dấu ngoặc nhọn:

<https://www.example.com>
<https://github.com/user/repo>

Hiệu ứng kết xuất:

https://www.example.comhttps://github.com/user/repo

Liên kết email tự động

Liên hệ tôi: <user@example.com>
Hỗ trợ kỹ thuật: <support@company.com>

Hiệu ứng kết xuất:

Liên hệ tôi: user@example.com Hỗ trợ kỹ thuật: support@company.com

Liên kết nội bộ

Liên kết neo

Liên kết tới tiêu đề trong cùng một trang:

Chuyển đến [Cú pháp liên kết cơ bản](#cú-pháp-liên-kết-cơ-bản)
Xem [Thực hành tốt nhất](#thực-hành-tốt-nhất)

Hiệu ứng kết xuất:

Chuyển đến Cú pháp liên kết cơ bản Xem Thực hành tốt nhất

Liên kết đường dẫn tương đối

Liên kết tới các tệp khác:

Xem [Cú pháp tiêu đề](headings.md)
Quay lại [Trang chủ](../index.md)

Liên kết đặc biệt

Liên kết hình ảnh

Bọc hình ảnh trong liên kết:

[![Văn bản thay thế](image.png)](https://www.example.com)

Liên kết tải xuống

Liên kết tới tệp tải xuống:

Tải xuống [Sổ tay người dùng](files/manual.pdf)
Lấy [Mã ví dụ](examples/demo.zip)

Định dạng văn bản liên kết

Văn bản liên kết có định dạng

Đây là [**liên kết đậm**](https://www.example.com)
Đây là [*liên kết nghiêng*](https://www.example.com)
Đây là [``liên kết kiểu mã`](https://www.example.com)

Hiệu ứng kết xuất:

Đây là liên kết đậm Đây là liên kết nghiêng Đây là liên kết kiểu mã

Văn bản liên kết nhiều dòng

Đây là [văn bản liên kết rất dài,
có thể cần xuống dòng](https://www.example.com)

Lỗi thường gặp và giải pháp

1. Dấu ngoặc không khớp

❌ Lỗi:
[văn bản liên kết(https://www.example.com)  ← Thiếu dấu ngoặc đóng

✅ Đúng:
[văn bản liên kết](https://www.example.com)

2. Vấn đề khoảng trắng

❌ Lỗi:
[ văn bản liên kết ]( https://www.example.com )  ← Khoảng trắng không cần thiết

✅ Đúng:
[văn bản liên kết](https://www.example.com)

3. Mã hóa URL

Đối với URL chứa ký tự đặc biệt:

❌ Có thể có vấn đề:
[Tìm kiếm](https://www.google.com/search?q=markdown)

✅ An toàn hơn:
[Tìm kiếm](https://www.google.com/search?q=markdown)
hoặc sử dụng tham chiếu:
[Tìm kiếm][google-search]

[google-search]: https://www.google.com/search?q=markdown

Thực hành tốt nhất

1. Sử dụng văn bản liên kết mô tả

✅ Khuyến nghị: Văn bản mô tả
Xem [Tài liệu cú pháp Markdown chính thức](https://daringfireball.net/projects/markdown/syntax)

❌ Không khuyến nghị: Văn bản chung
Nhấp [ở đây](https://daringfireball.net/projects/markdown/syntax) để xem tài liệu

2. Liên kết tham chiếu cho tài liệu dài

✅ Khuyến nghị: Tài liệu dài sử dụng tham chiếu
Trong nghiên cứu của chúng tôi, chúng tôi đã tham khảo [công trình của Smith và cộng sự][smith2020],
[lý thuyết của Jones][jones2019] và [báo cáo ngành mới nhất][industry2021].

[smith2020]: https://www.markdownlang.com/smith-2020-paper
[jones2019]: https://www.markdownlang.com/jones-theory
[industry2021]: https://www.markdownlang.com/industry-report-2021

3. Giữ URL ngắn gọn

✅ Khuyến nghị: Sử dụng URL ngắn hoặc tên miền tùy chỉnh
[Trang chủ dự án](https://myproject.com)

✅ Chấp nhận được: URL dài sử dụng tham chiếu
Xem [báo cáo phân tích chi tiết của chúng tôi][detailed-report]

[detailed-report]: https://company.com/reports/2023/detailed-analysis-q4-performance-metrics

Xác minh liên kết

Kiểm tra tính hợp lệ của liên kết

Kiểm tra định kỳ các liên kết trong tài liệu:

<!-- Khuyến nghị thêm nhận xét đánh dấu trạng thái liên kết -->
[Liên kết hoạt động](https://www.google.com) <!-- ✓ 2023-01-15 -->
[Liên kết không dùng nữa](https://old-site.com) <!-- ⚠️ Có thể không hoạt động -->

Sử dụng công cụ xác minh

• linkchecker - Công cụ kiểm tra liên kết dòng lệnh
• markdown-link-check - Xác minh liên kết Node.js
• VS Code Plugin - Xác minh liên kết thời gian thực

Đầu ra HTML

Liên kết Markdown chuyển đổi thành HTML:

[văn bản liên kết](https://www.example.com "tiêu đề")

Chuyển đổi thành:

<a href="https://www.example.com" title="tiêu đề">văn bản liên kết</a>

Kỹ thuật nâng cao

1. Liên kết có điều kiện

Quyết định động có thêm liên kết hay không dựa trên ngữ cảnh:

Trong môi trường phát triển, truy cập [máy chủ cục bộ](http://localhost:3000)
Trong môi trường sản xuất, truy cập [máy chủ trực tuyến](https://production.example.com)

2. Nhóm liên kết

Quản lý các liên kết liên quan theo nhóm:

<!-- Tài nguyên chính thức -->
[Trang web chính thức][official]
[Tài liệu chính thức][docs]
[Blog chính thức][blog]

<!-- Tài nguyên cộng đồng -->
[Kho lưu trữ GitHub][github]
[Thảo luận diễn đàn][forum]
[Blog cộng đồng][community]

[official]: https://www.markdownlang.com
[docs]: https://docs.example.com
[blog]: https://blog.example.com
[github]: https://github.com/example/project
[forum]: https://forum.example.com
[community]: https://community.example.com

3. Liên kết đa ngôn ngữ

Xem tài liệu: [English](README.md) | [Tiếng Việt](README-vi.md) | [日本語](README-ja.md)

Ví dụ thực tế

Menu điều hướng

## Điều hướng nhanh

**Hướng dẫn bắt đầu**
- [Markdown là gì](what-is-markdown.md)
- [Cài đặt trình soạn thảo](install-editor.md)
- [Tài liệu đầu tiên](first-document.md)

**Tham khảo cú pháp**
- [Cú pháp cơ bản](basic-syntax.md)
- [Cú pháp mở rộng](extended-syntax.md)
- [Thực hành tốt nhất](best-practices.md)

**Liên kết tài nguyên**
- [Trang web chính thức](https://daringfireball.net/projects/markdown/)
- [Trình soạn thảo trực tuyến](https://dillinger.io/)
- [Công cụ kiểm tra cú pháp](https://markdownlint.github.io/)

Tài liệu tham khảo

## Tài liệu tham khảo

Tài liệu này dựa trên các tài nguyên sau:

1. [Cú pháp Markdown chính thức][markdown-syntax] - John Gruber
2. [Đặc tả CommonMark][commonmark] - Tiêu chuẩn hóa Markdown
3. [GitHub Flavored Markdown][gfm] - Cú pháp mở rộng GitHub
4. [Hướng dẫn Markdown][markdown-guide] - Tài nguyên học tập toàn diện

[markdown-syntax]: https://daringfireball.net/projects/markdown/syntax
[commonmark]: https://commonmark.org/
[gfm]: https://github.github.com/gfm/
[markdown-guide]: https://www.markdownguide.org/

Đề xuất công cụ

## Công cụ được đề xuất

### Trình soạn thảo
- [Typora](https://typora.io/) - Trình soạn thảo WYSIWYG
- [Mark Text](https://marktext.app/) - Trình soạn thảo mã nguồn mở miễn phí
- [VS Code](https://code.visualstudio.com/) + Plugin Markdown

### Công cụ trực tuyến
- [Dillinger](https://dillinger.io/) - Trình soạn thảo trực tuyến
- [StackEdit](https://stackedit.io/) - Trình soạn thảo trực tuyến đầy đủ tính năng
- [Markdown to HTML](https://markdowntohtml.com/) - Chuyển đổi định dạng

### Trình tạo trang web tĩnh
- [VitePress](https://vitepress.dev/) - Hệ sinh thái Vue
- [Docusaurus](https://docusaurus.io/) - Hệ sinh thái React
- [GitBook](https://gitbook.com/) - Nền tảng tài liệu

Cú pháp liên quan

• Cú pháp hình ảnh - Chèn hình ảnh
• Cú pháp trích dẫn - Văn bản trích dẫn
• Cú pháp mã - Định dạng mã
• Liên kết tự động - Chức năng liên kết mở rộng

Luyện tập

Hãy thử tạo các loại liên kết sau:

1. Một danh sách tài nguyên chứa nhiều liên kết bên ngoài
2. Một tài liệu kỹ thuật sử dụng liên kết tham chiếu
3. Một tài liệu dài với điều hướng nội bộ
4. Một trang liên hệ chứa liên kết email và trang web