Liên kết nội bộ, liên kết ngược và đồ thị trong VS Code

Các file Markdown riêng lẻ trở nên hữu ích hơn khi bạn nhìn thấy quan hệ giữa chúng. Markdown Live Editor lập chỉ mục liên kết trong thư mục làm việc để hỗ trợ Wikilink, liên kết đến, liên kết đi, đồ thị cục bộ và đồ thị toàn cục.

Thư mục làm việc và kho ghi chú Obsidian

Trong Obsidian, Vault¹ là thư mục gốc chứa hệ thống ghi chú. Markdown Live Editor sử dụng thư mục làm việc của VS Code làm phạm vi tương đương, nhưng không thay đổi cấu trúc kho mã nguồn hoặc yêu cầu chuyển file sang một Vault riêng.

Bạn có thể giới hạn phạm vi ghi chú bằng markdownLive.sidebarScanDirectory. Để trống cấu hình này nếu muốn quét toàn bộ thư mục làm việc.

Tạo và mở liên kết nội bộ

Gõ [[ trong chế độ trực quan để tìm file. Khi chọn một kết quả, tiện ích tạo đường dẫn tương đối phù hợp với file hiện tại. Nhấp vào liên kết Markdown cục bộ sẽ mở tài liệu đích trong Markdown Live Editor; liên kết web và email được chuyển đến ứng dụng phù hợp.

Để theo dõi kết nối của tài liệu đang mở, phần Links (Liên kết) trong thanh bên Markdown Live chia thành:

• Incoming Links: những ghi chú đang trỏ đến file hiện tại.
• Outgoing Links: những ghi chú được file hiện tại liên kết đến.

Hai nhóm này tương ứng với liên kết ngược và liên kết đi của Obsidian. Tuy nhiên, tiện ích chưa hỗ trợ đầy đủ khả năng tìm những nơi nhắc đến tên ghi chú nhưng chưa tạo liên kết của Obsidian.

Chỉ mục liên kết được lưu lại

Tiện ích xây dựng chỉ mục liên kết và lưu tại .vscode/markdown-live-index.json. Nhờ đó, thanh bên và đồ thị không phải phân tích lại toàn bộ thư mục làm việc mỗi lần mở.

Khi cấu trúc file hoặc liên kết thay đổi lớn, chạy lệnh Markdown Live: Re-index Vault (Lập lại chỉ mục kho ghi chú) từ bảng lệnh của VS Code.

Đồ thị cục bộ: xem ngữ cảnh của ghi chú hiện tại

Đồ thị cục bộ nằm trong thanh bên Markdown Live và lấy file đang mở làm điểm trung tâm. Đồ thị theo dõi cả liên kết đến lẫn liên kết đi theo số lớp được đặt bởi markdownLive.graphDepth.

Đồ thị cục bộ phù hợp để trả lời:

• Tài liệu này phụ thuộc vào những ghi chú nào?
• Những tài liệu nào đang tham chiếu đến nó?
• Trong một hoặc hai bước liên kết, ngữ cảnh gần nhất là gì?

Khi bạn chuyển thẻ tài liệu, điểm trung tâm và tập liên kết liên quan được cập nhật theo tài liệu mới.

Đồ thị toàn cục: nhìn toàn bộ hệ thống tài liệu

Chạy Markdown Live: Show Global Graph (Hiện đồ thị toàn cục) từ bảng lệnh hoặc mở từ đồ thị cục bộ để xem các quan hệ trong toàn bộ phạm vi đã chọn.

Đồ thị toàn cục phù hợp khi cần:

• Phát hiện các cụm tài liệu có nhiều liên kết.
• Tìm ghi chú chưa được kết nối bằng tùy chọn Show Orphans (Hiện ghi chú rời rạc).
• Kiểm tra cấu trúc tài liệu của một kho mã nguồn.
• Tìm điểm trên đồ thị theo tên file hoặc thẻ.
• Quan sát hướng liên kết bằng arrows.
• Phân biệt nhóm tài liệu theo màu thư mục.

Nhãn và màu điểm trên đồ thị

Đồ thị ưu tiên nhãn dễ đọc theo thứ tự:

1. Trường YAML title, nếu có.
2. Heading H1 đầu tiên.
3. Tên file.

Bạn có thể đặt YAML color để cung cấp màu riêng cho từng điểm. Khi không có màu cụ thể, đồ thị có thể phân biệt điểm theo thư mục.

Hiểu đúng vai trò của đồ thị liên kết

Đồ thị liên kết là công cụ điều hướng và khám phá cấu trúc, không tự động đánh giá chất lượng nội dung. Một đồ thị dày đặc chưa chắc tốt hơn; điều quan trọng là mỗi liên kết giúp người đọc đi đến bối cảnh liên quan.

Với tài liệu sản phẩm hoặc kho mã nguồn, hãy ưu tiên:

• Liên kết từ overview đến hướng dẫn chi tiết.
• Liên kết ngược từ trang tra cứu về quy trình chính.
• Tránh tạo Wikilink chỉ để làm đồ thị “đẹp”.
• Dùng chế độ hiện ghi chú rời rạc để tìm tài liệu chưa được đưa vào hành trình đọc.

Tiếp theo: Quản lý hình ảnh và mẫu tài liệu Markdown.

Footnotes

1. Vault là tên Obsidian dùng cho thư mục gốc chứa một hệ thống ghi chú. ↩