---

1. Cài đặt

1. Cài đặt Obsidian - Tải xuống và cài đặt từ obsidian.md
2. Bật các plugin cộng đồng - Truy cập Cài đặt → Plugin cộng đồng → Bật các plugin cộng đồng
3. Cài đặt Notebook Navigator - Nhấp vào "Browse" → Tìm kiếm "Notebook Navigator" → Cài đặt
4. Cài đặt Cài đặt Phong cách (tùy chọn) - Để tùy chỉnh màu sắc và giao diện, hãy cài đặt plugin Cài đặt Phong cách bằng cách tìm kiếm "Cài đặt Phong cách" trong các plugin của Cộng đồng

2 Bắt đầu

Dưới đây là hướng dẫn chính thức để học và thành thạo Notebook Navigator:

Video có phụ đề bằng 21 ngôn ngữ.

3. An toàn và chất lượng

Notebook Navigator được kiểm tra bằng TypeScript, ESLint (sử dụng plugin ESLint chính thức của Obsidian), Prettier, Vitest và quá trình xây dựng bản phát hành trước khi các thay đổi được hợp nhất. Quá trình xây dựng phải hoàn tất mà không có lỗi hay cảnh báo nào.

Các kiểm tra bảo mật được thực hiện thông qua CodeQL, với lịch sử quét được ghi lại trong các lần chạy quy trình làm việc của CodeQL và Bảng điểm OpenSSF. Trạng thái hiện tại được hiển thị trong các biểu tượng ở đầu trang này.

Notebook Navigator chạy trên máy cục bộ, nhưng một số tính năng sẽ gửi các yêu cầu HTTP được ghi lại để cập nhật, tải xuống và truy cập nội dung từ xa. Xem phần 10 - Thông tin về Mạng và Chẩn đoán để xem danh sách đầy đủ.

Mục lục

• 4. Tài liệu
• 4 phím tắt
• 5 Cài đặt đồng bộ và cài đặt cục bộ
• 6 Tìm kiếm
• 7 phím tắt tùy chỉnh
• 8 lệnh
• 9 tính năng
• 10 Thông tin về mạng và chẩn đoán
• 11 Lịch sử ngôi sao
• 12 Liên hệ
• 13 Câu hỏi hay thắc mắc?
• 14 Giấy phép

4 Phím tắt bàn phím

Chìa khóa	Hành động
↑/↓	Di chuyển lên/xuống trong khung hiện tại
←	Trong khung điều hướng: thu gọn hoặc chuyển đến khung cha Trong khung danh sách: chuyển sang khung điều hướng
→	Trong khung điều hướng: mở rộng hoặc chuyển sang khung danh sách Trong khung danh sách: chuyển sang khung soạn thảo
Tab	Trong khung điều hướng: chuyển sang khung danh sách Trong khung danh sách: chuyển sang khung soạn thảo Trong trường tìm kiếm: chuyển sang khung danh sách
Shift+Tab	Trong khung danh sách: chuyển sang khung điều hướng Trong trường tìm kiếm: chuyển sang khung điều hướng
Enter (macOS) F2 (Windows/Linux)	Đổi tên mục trực tiếp trong khung điều hướng hoặc khung danh sách
Enter	Trong khung điều hướng: mở ghi chú thư mục trên Windows/Linux theo mặc định (khi được bật) Trong khung danh sách: mở tệp đã chọn trên tất cả các hệ thống (khi được bật) Trong trường tìm kiếm: chuyển sang khung danh sách
Phím Esc	Trong trường tìm kiếm: đóng tìm kiếm và chuyển trọng tâm sang khung danh sách
PageUp/PageDown	Cuộn lên/xuống trong khung điều hướng và khung danh sách
Home/End	Chuyển đến mục đầu tiên/cuối cùng trong khung hiện tại
Xóa Backspace	Xóa mục đã chọn
Cmd/Ctrl+A	Chọn tất cả các ghi chú trong thư mục hiện tại
Cmd/Ctrl + Nhấp chuột	Chuyển đổi trạng thái chọn ghi chú
Shift + Nhấp chuột	Chọn một dải ghi chú
Shift + Home/End	Chọn từ vị trí hiện tại đến mục đầu tiên/cuối cùng
Shift + ↑/↓	Mở rộng vùng chọn lên/xuống
Cmd/Ctrl+↑/↓	Sắp xếp lại các tệp đã chọn lên/xuống trong chế độ sắp xếp thủ công

Lưu ý: Tất cả các phím tắt đều có thể tùy chỉnh. Xem phần 7 - Phím tắt tùy chỉnh để biết thêm chi tiết về cách thêm các phím điều hướng theo kiểu VIM (h, j, k, l), các phím thay thế và các tổ hợp phím điều khiển.

5 Cài đặt đồng bộ và cài đặt cục bộ

Nhiều tùy chọn trong Notebook Navigator hiển thị công tắc đồng bộ hóa — biểu tượng đám mây cho phép chuyển đổi giữa "Bật đồng bộ hóa" và "Tắt đồng bộ hóa". Tính năng này kiểm soát vị trí lưu trữ của từng tùy chọn và liệu chúng có được chia sẻ giữa các thiết bị hay không.

5.1 Cách thức hoạt động của tính năng đồng bộ hóa

Các plugin của Obsidian lưu trữ cấu hình của chúng trong tệp ` data.json`, nằm trong thư mục ` .obsidian/plugins/notebook-navigator/data.json ` bên trong thư mục vault của bạn. Khi bạn sử dụng dịch vụ đồng bộ hóa — chẳng hạn như Obsidian Sync, iCloud, GitHub, Dropbox hoặc Google Drive — tệp này sẽ được đồng bộ hóa trên tất cả các thiết bị của bạn cùng với phần còn lại của vault. Bất kỳ cài đặt nào được lưu vào ` data.json ` sẽ được đồng bộ hóa đến mọi thiết bị đồng bộ hóa vault.

Khi tính năng đồng bộ hóa được bật (mặc định) cho một cài đặt, giá trị sẽ được lưu vào data.json và đồng bộ hóa đến tất cả các thiết bị thông qua dịch vụ đồng bộ hóa của bạn.

Khi tính năng đồng bộ hóa bị tắt cho một cài đặt, giá trị của cài đặt đó sẽ được lưu trữ trong bộ nhớ cục bộ của Obsidian. Bộ nhớ cục bộ là riêng cho từng thiết bị và không được bao gồm trong quá trình đồng bộ hóa kho lưu trữ. Mỗi thiết bị sẽ có giá trị độc lập cho cài đặt đó. Khi bạn tắt tính năng đồng bộ hóa cho một cài đặt, giá trị hiện tại sẽ được sao chép vào bộ nhớ cục bộ trên thiết bị hiện tại, và giá trị đó sẽ bị xóa khỏi kho lưu trữ ( data.json ) để tránh ghi đè lên các giá trị cục bộ trên các thiết bị khác.

Nếu bạn không sử dụng dịch vụ đồng bộ hóa, nút bật/tắt đồng bộ hóa sẽ không có tác dụng thực tế vì tệp ` data.json ` chỉ được lưu trữ cục bộ.

6 Tìm kiếm

Notebook Navigator có hai chế độ tìm kiếm: tìm kiếm theo bộ lọc và Omnisearch. Chuyển đổi giữa hai chế độ này bằng cách sử dụng các phím mũi tên lên/xuống hoặc nhấp vào biểu tượng tìm kiếm. Kết hợp tên tệp, thuộc tính, thẻ, ngày tháng và bộ lọc trong một truy vấn (ví dụ: meeting .status=active #work @thisweek).

6.1 Lọc tìm kiếm

Lọc tệp theo tên, thẻ, thuộc tính, ngày tháng, thư mục, phần mở rộng và tác vụ trong thư mục hiện tại và các thư mục con. Chế độ tìm kiếm mặc định.

Tên tệp

• word - Ghi chú trận đấu có từ "word" trong tên tệp
• word1 word2 - Yêu cầu mỗi từ phải trùng khớp với tên tệp
• -word - Loại trừ các ghi chú có từ "word" trong tên tệp

Thẻ

• #tag - Thêm ghi chú có thẻ (cũng khớp với các thẻ lồng nhau như #tag/subtag)
• # - Chỉ bao gồm các ghi chú được gắn thẻ
• -#tag - Loại trừ các ghi chú có thẻ
• -# - Chỉ bao gồm các ghi chú chưa được gắn thẻ
• #tag1 #tag2 - Khớp cả hai thẻ (AND ngầm định)
• #tag1 AND #tag2 - Khớp cả hai thẻ (AND rõ ràng)
• #tag1 OR #tag2 - Khớp với bất kỳ thẻ nào
• #a OR #b AND #c - AND có ưu tiên cao hơn: khớp với #a, hoặc cả #b và #c
• Nhấn Cmd/Ctrl + nhấp chuột vào thẻ để thêm với AND. Nhấn Cmd/Ctrl + Shift + nhấp chuột để thêm với OR

Tính chất

• .key - Ghi chú kèm theo khóa thuộc tính
• .key=value - Ghi chú trong trường hợp giá trị thuộc tính chứa value
• ."Reading Status" - Khóa thuộc tính có khoảng trắng (được đặt trong dấu ngoặc kép)
• ."Reading Status"="In Progress" - Các khóa và giá trị chứa khoảng trắng phải được đặt trong dấu ngoặc kép
• -.key - Loại trừ các ghi chú có khóa thuộc tính
• -.key=value - Loại trừ các ghi chú có giá trị thuộc tính chứa value
• Nhấn Cmd/Ctrl + nhấp chuột vào một thuộc tính để thêm bằng AND. Nhấn Cmd/Ctrl + Shift + nhấp chuột để thêm bằng OR

Bộ lọc

• has:task - Ghi chú kèm theo các tác vụ chưa hoàn thành
• -has:task - Loại trừ các ghi chú có tác vụ chưa hoàn thành
• folder:meetings - Ghi chú ở những nơi tên thư mục chứa meetings
• folder:/work/meetings - Chỉ bao gồm ghi chú trong thư mục " work/meetings " (không bao gồm các thư mục con)
• folder:/ - Chỉ bao gồm ghi chú trong thư mục gốc của kho lưu trữ
• -folder:archive - Loại trừ các ghi chú có tên thư mục chứa archive
• -folder:/archive - Loại trừ các ghi chú chỉ trong thư mục " archive " (không bao gồm các thư mục con)
• ext:md - Ghi chú có phần mở rộng md (ext:.md cũng được hỗ trợ)
• -ext:pdf - Loại trừ các ghi chú có phần mở rộng pdf
• Kết hợp với thẻ, tên và ngày tháng (ví dụ: folder:/work/meetings ext:md @thisweek)

Ngày

• @today - Ghi chú trận đấu hôm nay bằng trường ngày mặc định
• @yesterday, @last7d, @last30d, @thisweek, @thismonth - Khoảng thời gian tương đối
• @2026-02-07 - Khớp với một ngày duy nhất (cũng hỗ trợ @20260207)
• @2026 - Khớp với năm dương lịch
• @2026-02 hoặc @202602 - Khớp với tháng lịch
• @2026-W05 hoặc @2026W05 - Khớp với tuần ISO
• @2026-Q2 hoặc @2026Q2 - Khớp với quý lịch
• @13/02/2026 - Định dạng số có dấu phân cách (@07022026 sẽ tuân theo vùng địa phương của bạn khi có sự không rõ ràng)
• @2026-02-01..2026-02-07 - Chọn khoảng thời gian linh hoạt (hỗ trợ khoảng thời gian mở)
• @c:... hoặc @m:... - Ngày tạo hoặc sửa đổi mục tiêu
• -@... - Loại trừ khớp ngày

Trường ngày mặc định tuân theo thứ tự sắp xếp hiện tại. Khi sắp xếp theo tên, trường ngày được cấu hình trong Cài đặt → Ghi chú → Ngày → Khi sắp xếp theo tên.

Hành vi AND/OR

AND và các toán tử ` OR ` hoạt động trong các truy vấn chỉ chứa thẻ/tính năng (các truy vấn chỉ bao gồm các bộ lọc ` #tag`, ` -#tag`, ` #`, ` -#`, ` .key`, ` -.key`, ` .key=value` hoặc ` -.key=value `). Nếu truy vấn cũng bao gồm tên, ngày, bộ lọc tác vụ, bộ lọc thư mục hoặc bộ lọc mở rộng, ` AND ` và ` OR ` sẽ được khớp như các từ trong tên tệp thay vì các từ khóa.

• Câu hỏi của người vận hành: #work OR .status=started
• Truy vấn hỗn hợp: #work OR ext:md (OR được khớp trong tên tệp)

6.2 Omnisearch

Tìm kiếm toàn văn bản trong kho lưu trữ, lọc theo thư mục hiện tại, các thư mục con hoặc thẻ đã chọn. Yêu cầu cài đặt plugin Omnisearch. Nếu Omnisearch chưa được cài đặt, chức năng tìm kiếm sẽ chuyển sang chế độ tìm kiếm lọc.

Xem trước ghi chú hiển thị các đoạn trích kết quả Omnisearch thay vì văn bản xem trước mặc định.

Những hạn chế đã biết

• Hiệu suất - Có thể chậm khi tìm kiếm ít hơn 3 ký tự trong các kho lưu trữ lớn
• Bộ lọc đường dẫn - Phạm vi thư mục chỉ được gửi đến Omnisearch đối với các đường dẫn ASCII đơn giản. Các đường dẫn khác sẽ được lọc sau khi Omnisearch trả về kết quả
• Kết quả giới hạn - Omnisearch tìm kiếm toàn bộ kho lưu trữ và trả về một số lượng kết quả giới hạn trước khi lọc, do đó các tệp liên quan từ thư mục hiện tại có thể không hiển thị nếu có nhiều kết quả trùng khớp ở các vị trí khác
• Xem trước văn bản - Các bản xem trước ghi chú được thay thế bằng các đoạn trích từ kết quả tìm kiếm Omnisearch, có thể không hiển thị phần đánh dấu kết quả tìm kiếm thực tế nếu nó xuất hiện ở vị trí khác trong tệp

7 phím tắt tùy chỉnh

Chỉnh sửa tệp ` .obsidian/plugins/notebook-navigator/data.json ` để tùy chỉnh phím tắt của Notebook Navigator. Mở tệp và tìm phần ` keyboardShortcuts `. Mỗi mục trong phần này sẽ gán một hành động cho một hoặc nhiều phím tắt:

"pane:move-up": [ { "key": "ArrowUp", "modifiers": [] }, { "key": "K", "modifiers": [] } ]

Thêm nhiều phím tắt cho mỗi hành động để hỗ trợ các phím thay thế, như ví dụ về phím tắt " ArrowUp " và " K " ở trên. Kết hợp các phím sửa đổi trong một mục bằng cách liệt kê từng giá trị, ví dụ: " "modifiers": ["Mod", "Shift"]". Các chuỗi phím như " gg " hoặc " dd " không được hỗ trợ. Tải lại Obsidian sau khi chỉnh sửa tệp.

7.1 Các yếu tố điều chỉnh

Phụ từ	Phím
Mod	Cmd (macOS) / Ctrl (Windows/Linux)
Alt	Alt / Option
Shift	Shift
Ctrl	Control (khuyến nghị sử dụng Mod cho đa nền tảng)

7.2 hành động có thể thực hiện

Hành động	Phím mặc định
pane:move-up	Mũi tên lên
pane:move-down	Mũi tên xuống
pane:page-up	Trang lên
pane:page-down	PageDown
pane:home	Trang chủ
pane:end	End
pane:rename	Enter (macOS), F2 (Windows/Linux)
pane:delete-selected	Delete, Backspace
navigation:collapse-or-parent	Mũi tên trái
navigation:expand-or-focus-list	Mũi tên sang phải
navigation:focus-list	Tab
list:focus-navigation	Mũi tên trái, Shift+Tab
list:focus-editor	Mũi tên phải, Tab
list:select-all	Mod+A
list:extend-selection-up	Shift + Mũi tên lên
list:extend-selection-down	Shift + Mũi tên xuống
list:manual-sort-up	Mod + Mũi tên lên
list:manual-sort-down	Mod + Mũi tên xuống
list:range-to-start	Shift+Home
list:range-to-end	Shift + End
search:focus-list	Tab, Enter
search:focus-navigation	Shift + Tab
search:close	Escape

8 lệnh

Đặt phím tắt tùy chỉnh cho các lệnh này trong cài đặt Phím tắt của Obsidian:

Xem & điều hướng

• Notebook Navigator: Open Mở Notebook Navigator trong thanh bên trái. Nếu đã mở, di chuyển tiêu điểm bàn phím sang khung danh sách. Gợi ý: Gán phím tắt như Cmd/Ctrl+Shift+E để di chuyển tiêu điểm bàn phím sang khung danh sách - điều này là cần thiết cho việc điều hướng bằng bàn phím đầy đủ
• Notebook Navigator: Toggle left sidebar Bật/tắt thanh bên trái. Khi mở, thiết lập chế độ xem thanh bên trái thành Notebook Navigator (khác với lệnh "Bật/tắt thanh bên trái" tích hợp sẵn của Obsidian, vốn khôi phục chế độ xem thanh bên trái trước đó)
• Notebook Navigator: Open homepage Mở chế độ xem Trình duyệt sổ tay và tải trang chủ đã được định cấu hình trong cài đặt
• Notebook Navigator: Select vault profile Mở cửa sổ pop-up để chuyển đổi giữa các hồ sơ kho lưu trữ
• Notebook Navigator: Reveal file Hiển thị tệp hiện tại trong trình duyệt. Mở rộng các thư mục cha và cuộn đến tệp. Lệnh này hữu ích nếu bạn đã tắt cài đặt " Auto-reveal active note " và muốn hiển thị ghi chú thủ công. Gợi ý: Gán phím tắt như " Cmd/Ctrl+Shift+R " để nhanh chóng thay đổi thư mục hoặc thẻ được chọn thành tệp hiện tại
• Notebook Navigator: Open all files Mở tất cả các ghi chú trong thư mục hoặc thẻ hiện đang được chọn. Khi mở 15 tệp trở lên, hiển thị hộp thoại xác nhận
• Notebook Navigator: Navigate to folder Hộp thoại tìm kiếm để chuyển đến bất kỳ thư mục nào
• Notebook Navigator: Navigate to tag Hộp thoại tìm kiếm để chuyển đến bất kỳ thẻ nào
• Notebook Navigator: Navigate to property Hộp thoại tìm kiếm để chuyển đến bất kỳ khóa hoặc giá trị thuộc tính nào
• Notebook Navigator: Navigate back Chuyển đến thư mục, thẻ hoặc tùy chọn thuộc tính trước đó trong lịch sử trình duyệt
• Notebook Navigator: Navigate forward Chuyển đến thư mục, thẻ hoặc tùy chọn thuộc tính tiếp theo trong lịch sử trình duyệt
• Notebook Navigator: Add to shortcuts Thêm hoặc xóa tệp, thư mục, thẻ hoặc thuộc tính hiện tại khỏi các phím tắt
• Notebook Navigator: Open shortcut 1-9 Mở lối tắt theo vị trí của nó trong danh sách lối tắt
• Notebook Navigator: Search Mở trường tìm kiếm nhanh hoặc tập trung vào nó nếu đã mở. Tìm kiếm được lưu giữ giữa các phiên. Gợi ý: Gán phím tắt như " Cmd/Ctrl+Shift+S " để lọc tệp nhanh chóng
• Notebook Navigator: Search whole vault Chọn thư mục gốc của kho lưu trữ và mở tính năng tìm kiếm bao gồm cả các thư mục con (yêu cầu phải bật tính năng “ Show root folder ”)

Lựa chọn

• Notebook Navigator: Select next file Chuyển lựa chọn sang tệp tiếp theo trong thư mục hiện tại hoặc chế độ xem thẻ. Tuân thủ thứ tự sắp xếp tùy chỉnh. Gợi ý: Gán phím tắt như " Option+Cmd+Right " để nhanh chóng chuyển đến tệp tiếp theo trong danh sách
• Notebook Navigator: Select previous file Chuyển lựa chọn sang tệp trước đó trong thư mục hiện tại hoặc chế độ xem thẻ. Tuân thủ thứ tự sắp xếp tùy chỉnh. Gợi ý: Gán phím tắt như " Option+Cmd+Left " để nhanh chóng chuyển đến tệp trước đó trong danh sách

Bố cục & hiển thị

• Notebook Navigator: Toggle dual pane layout Chuyển đổi giữa chế độ xem một cửa sổ và hai cửa sổ (trên máy tính để bàn). Gợi ý: Gán phím tắt như ` Cmd/Ctrl+Shift+A ` để nhanh chóng chuyển đổi giữa chế độ xem một cửa sổ và hai cửa sổ
• Notebook Navigator: Toggle dual pane orientation Chuyển đổi hướng hiển thị hai cửa sổ giữa ngang và dọc
• Notebook Navigator: Toggle descendants Bật/tắt hiển thị ghi chú của các thư mục con/thư mục con cấp dưới cho thư mục và thẻ. Gợi ý: Gán phím tắt như " Cmd/Ctrl+Shift+D " để nhanh chóng bật/tắt hiển thị ghi chú từ các thư mục con/thư mục con cấp dưới
• Notebook Navigator: Toggle hidden folders, tags, and notes Hiển thị hoặc ẩn các thư mục ẩn, thẻ và ghi chú
• Notebook Navigator: Toggle tag sort order Chuyển đổi giữa chế độ sắp xếp thẻ theo thứ tự bảng chữ cái và theo tần suất
• Notebook Navigator: Toggle tags by selection Chuyển sang chỉ hiển thị các thẻ có trong các ghi chú thuộc thư mục hoặc thuộc tính đã chọn
• Notebook Navigator: Toggle properties by selection Chuyển sang chỉ hiển thị các thuộc tính có trong các ghi chú thuộc thư mục hoặc thẻ đã chọn
• Notebook Navigator: Toggle compact mode Chuyển đổi chế độ danh sách giữa chế độ tiêu chuẩn và chế độ gọn nhẹ
• Notebook Navigator: Toggle pinned section Hiển thị hoặc ẩn các ghi chú được ghim trong khung danh sách
• Notebook Navigator: Collapse / expand all items Thu gọn hoặc mở rộng tất cả các mục dựa trên trạng thái hiện tại. Khi tùy chọn " Keep selected item expanded " được bật (mặc định là bật), tất cả các thư mục trừ thư mục hiện tại sẽ được thu gọn. Tính năng này rất hữu ích để giữ cho cây điều hướng gọn gàng khi tìm kiếm tài liệu
• Notebook Navigator: Collapse / expand selected item Thu gọn hoặc mở rộng mục điều hướng đã chọn

Lịch

• Notebook Navigator: Toggle calendar Bật hoặc tắt lịch. Gợi ý: Gán phím tắt như Cmd/Ctrl+Shift+C để nhanh chóng hiển thị lịch
• Notebook Navigator: Open daily note Mở ghi chú hàng ngày của ngày hôm nay dựa trên cài đặt lịch. Tạo ghi chú nếu nó không tồn tại
• Notebook Navigator: Open weekly note Mở ghi chú hàng tuần hiện tại. Tạo ghi chú nếu nó không tồn tại
• Notebook Navigator: Open monthly note Mở ghi chú hàng tháng hiện tại. Tạo ghi chú nếu nó không tồn tại
• Notebook Navigator: Open quarterly note Mở ghi chú quý hiện tại. Tạo ghi chú nếu nó không tồn tại
• Notebook Navigator: Open yearly note Mở ghi chú hàng năm hiện tại. Tạo ghi chú nếu nó không tồn tại

Các thao tác với tệp tin

Lưu ý quan trọng: Obsidian không có khái niệm về "thư mục hiện tại hoặc thẻ", vì vậy khi tạo ghi chú trong Obsidian theo mặc định, chúng sẽ được tạo trong thư mục gốc, cùng thư mục với tệp hiện tại hoặc một thư mục cụ thể. Khi làm việc với Notebook Navigator, bạn luôn muốn tạo ghi chú mới trong thư mục hoặc thẻ hiện tại được chọn, vì vậy điều đầu tiên bạn nên làm là gán lệnh " Cmd/Ctrl+N " cho " Notebook Navigator: Create new note " để các ghi chú mới luôn được tạo trong thư mục hoặc thẻ hiện tại được chọn. Cùng nguyên tắc này cũng áp dụng cho việc di chuyển và xóa tệp. Đó là lý do tại sao bạn nên sử dụng các lệnh này thay vì các lệnh tích hợp sẵn của Obsidian khi sử dụng Notebook Navigator.

• Notebook Navigator: Create new note Tạo ghi chú trong thư mục hiện đang được chọn. Gợi ý: Gán phím tắt Cmd/Ctrl+N cho lệnh này (trước tiên hãy hủy gán phím tắt mặc định "Tạo ghi chú mới" của Obsidian)
• Notebook Navigator: Create new note from template Tạo ghi chú từ mẫu trong thư mục hiện đang được chọn (yêu cầu Templater)
• Notebook Navigator: Move files Di chuyển các tệp đã chọn sang một thư mục khác. Chọn tệp tiếp theo trong thư mục hiện tại
• Notebook Navigator: Merge notes Tạo một ghi chú từ các ghi chú Markdown đã chọn theo thứ tự hiện tại trong danh sách
• Notebook Navigator: Convert to folder note Tạo một thư mục có tên trùng khớp với tên tệp và di chuyển tệp vào bên trong thư mục đó như một ghi chú của thư mục
• Notebook Navigator: Set as folder note Đổi tên tệp đang hoạt động thành tên ghi chú của thư mục chứa nó
• Notebook Navigator: Detach folder note Tách tệp ghi chú khỏi thư mục đã chọn và đổi tên nó
• Notebook Navigator: Pin all folder notes Ghim tất cả các ghi chú thư mục trong tất cả các thư mục. Lệnh này chỉ hiển thị khi tính năng ghi chú thư mục được bật
• Notebook Navigator: Delete files Xóa các tệp đã chọn. Chọn tệp tiếp theo trong thư mục hiện tại

Các thao tác thẻ

• Notebook Navigator: Add tag to selected files Hộp thoại để thêm thẻ vào các tệp đã chọn. Hỗ trợ tạo thẻ mới
• Notebook Navigator: Set property on selected files Hộp thoại để thiết lập thuộc tính cho các tệp đã chọn
• Notebook Navigator: Remove tag from selected files Hộp thoại để xóa thẻ cụ thể. Xóa ngay lập tức nếu chỉ có một thẻ
• Notebook Navigator: Remove all tags from selected files Xóa tất cả thẻ khỏi các tệp đã chọn với xác nhận

Bảo trì

• Notebook Navigator: Rebuild cache Tái tạo bộ nhớ đệm của Notebook Navigator cục bộ. Sử dụng tùy chọn này nếu bạn gặp phải tình trạng thiếu thẻ, xem trước không chính xác hoặc thiếu hình ảnh tính năng

8.1 Mã lệnh

ID lệnh	Tên lệnh
notebook-navigator:open	Trình duyệt sổ tay: Mở
notebook-navigator:toggle-left-sidebar	Trình duyệt sổ tay: Bật/tắt thanh bên trái
notebook-navigator:open-homepage	Trình duyệt sổ tay: Mở trang chủ
notebook-navigator:select-profile	Trình điều hướng sổ tay: Chọn hồ sơ kho
notebook-navigator:select-profile-1	Trình điều hướng sổ tay: Chọn hồ sơ kho 1
notebook-navigator:select-profile-2	Trình điều hướng sổ tay: Chọn hồ sơ kho 2
notebook-navigator:select-profile-3	Trình duyệt sổ tay: Chọn hồ sơ kho 3
notebook-navigator:reveal-file	Trình duyệt sổ tay: Hiển thị tệp
notebook-navigator:open-all-files	Trình duyệt sổ tay: Mở tất cả các tệp
notebook-navigator:navigate-to-folder	Trình duyệt sổ tay: Điều hướng đến thư mục
notebook-navigator:navigate-to-tag	Trình duyệt sổ tay: Điều hướng đến thẻ
notebook-navigator:navigate-to-property	Trình duyệt sổ tay: Chuyển đến thuộc tính
notebook-navigator:navigate-back	Trình duyệt sổ tay: Quay lại
notebook-navigator:navigate-forward	Trình duyệt sổ tay: Di chuyển tiếp
notebook-navigator:add-shortcut	Trình điều hướng sổ tay: Thêm vào phím tắt
notebook-navigator:open-shortcut-1	Trình điều hướng sổ tay: Mở phím tắt 1
notebook-navigator:open-shortcut-2	Trình điều hướng sổ tay: Mở lối tắt 2
notebook-navigator:open-shortcut-3	Trình điều hướng sổ tay: Mở lối tắt 3
notebook-navigator:open-shortcut-4	Trình điều hướng sổ tay: Mở lối tắt 4
notebook-navigator:open-shortcut-5	Trình duyệt sổ tay: Mở lối tắt 5
notebook-navigator:open-shortcut-6	Trình duyệt sổ tay: Mở lối tắt 6
notebook-navigator:open-shortcut-7	Trình duyệt sổ tay: Mở lối tắt 7
notebook-navigator:open-shortcut-8	Trình duyệt sổ tay: Mở lối tắt 8
notebook-navigator:open-shortcut-9	Trình duyệt sổ tay: Mở lối tắt 9
notebook-navigator:search	Trình duyệt sổ tay: Tìm kiếm
notebook-navigator:search-vault	Trình duyệt sổ tay: Tìm kiếm toàn bộ kho lưu trữ
notebook-navigator:toggle-dual-pane	Trình duyệt sổ tay: Chuyển đổi chế độ hai khung
notebook-navigator:toggle-dual-pane-orientation	Trình duyệt sổ tay: Chuyển đổi hướng của hai khung
notebook-navigator:toggle-calendar	Trình duyệt sổ tay: Bật/tắt lịch
notebook-navigator:open-daily-note	Trình duyệt sổ tay: Mở ghi chú hàng ngày
notebook-navigator:open-weekly-note	Trình duyệt sổ tay: Mở ghi chú hàng tuần
notebook-navigator:open-monthly-note	Trình duyệt sổ tay: Mở ghi chú hàng tháng
notebook-navigator:open-quarterly-note	Trình duyệt sổ tay: Mở ghi chú quý
notebook-navigator:open-yearly-note	Trình duyệt sổ tay: Mở ghi chú hàng năm
notebook-navigator:toggle-descendants	Trình duyệt sổ tay: Bật/tắt các mục con
notebook-navigator:toggle-hidden	Trình duyệt sổ tay: Bật/tắt các thư mục ẩn, thẻ và ghi chú
notebook-navigator:toggle-tag-sort	Trình duyệt sổ tay: Bật/tắt thứ tự sắp xếp theo thẻ
notebook-navigator:toggle-tags-by-selection	Trình duyệt sổ tay: Bật/tắt thẻ theo lựa chọn
notebook-navigator:toggle-properties-by-selection	Trình duyệt sổ tay: Bật/tắt thuộc tính theo lựa chọn
notebook-navigator:toggle-compact-mode	Trình duyệt sổ tay: Bật/tắt chế độ gọn gàng
notebook-navigator:toggle-pinned-section	Trình duyệt sổ tay: Bật/tắt phần được ghim
notebook-navigator:collapse-expand	Trình duyệt sổ tay: Thu gọn / mở rộng tất cả các mục
notebook-navigator:collapse-expand-selected-item	Trình duyệt sổ tay: Thu gọn / mở rộng mục đã chọn
notebook-navigator:new-note	Trình duyệt sổ tay: Tạo ghi chú mới
notebook-navigator:new-note-from-template	Trình duyệt sổ tay: Tạo ghi chú mới từ mẫu
notebook-navigator:move-files	Trình duyệt sổ tay: Di chuyển tệp
notebook-navigator:merge-notes	Trình duyệt sổ tay: Ghép các ghi chú lại với nhau
notebook-navigator:select-next-file	Trình duyệt sổ tay: Chọn tệp tiếp theo
notebook-navigator:select-previous-file	Trình duyệt sổ tay: Chọn tệp trước đó
notebook-navigator:convert-to-folder-note	Trình duyệt sổ tay: Chuyển đổi thành ghi chú thư mục
notebook-navigator:set-as-folder-note	Trình duyệt sổ tay: Đặt làm ghi chú thư mục
notebook-navigator:detach-folder-note	Trình duyệt sổ tay: Tách ghi chú thư mục
notebook-navigator:pin-all-folder-notes	Trình duyệt sổ tay: Ghim tất cả ghi chú thư mục
notebook-navigator:delete-files	Trình duyệt sổ tay: Xóa tệp
notebook-navigator:add-tag	Trình duyệt sổ tay: Thêm thẻ vào các tệp đã chọn
notebook-navigator:set-property	Trình duyệt sổ tay: Đặt thuộc tính cho các tệp đã chọn
notebook-navigator:remove-tag	Trình duyệt sổ tay: Xóa thẻ khỏi các tệp đã chọn
notebook-navigator:remove-all-tags	Trình duyệt sổ tay: Xóa tất cả thẻ khỏi các tệp đã chọn
notebook-navigator:rebuild-cache	Notebook Navigator: Tái tạo bộ nhớ đệm

9 tính năng

9.1 Giao diện

• Bố cục hai khung - Khung điều hướng (thư mục/thẻ/thuộc tính) và khung danh sách (tệp)
• Chế độ cửa sổ đơn - Giao diện điều hướng và danh sách với hiệu ứng chuyển đổi động
• Các khung có thể điều chỉnh kích thước - Hướng chia ngang hoặc dọc
• Zoom giao diện người dùng độc lập - Điều chỉnh tỷ lệ hiển thị của Notebook Navigator mà không ảnh hưởng đến tỷ lệ zoom của Obsidian
• Giao diện khởi động - Ưu tiên điều hướng hoặc ưu tiên danh sách
• Hỗ trợ đa ngôn ngữ - 21 ngôn ngữ với hỗ trợ bố cục RTL
• Bộ biểu tượng giao diện - Biểu tượng giao diện người dùng có thể tùy chỉnh trong plugin

10.2. Điều hướng

• Profil kho lưu trữ - Nhiều chế độ xem lọc với các thư mục/thẻ/ghi chú ẩn theo từng profil, quyền truy cập tệp, banner và phím tắt
• Phím tắt - Ghi chú, thư mục, thẻ, thuộc tính và các tìm kiếm đã lưu, kèm theo tính năng ghim và sắp xếp lại thứ tự
• Ghi chú/tệp gần đây - Phần mục gần đây được lưu trữ theo từng hồ sơ kho lưu trữ, có thể ghim bằng các phím tắt
• Lịch - Lịch ghi chú hàng ngày với tính năng chọn ngày, xem trước hình ảnh nổi bật và hỗ trợ chia đôi theo chiều dọc
• Cây thư mục - Mở rộng/thu gọn điều hướng với thứ tự thư mục gốc được sắp xếp thủ công
• Cây thẻ - Thẻ phân cấp với thứ tự thẻ gốc có thể tùy chỉnh
• Trình duyệt thuộc tính tệp - Duyệt các thuộc tính tệp được sắp xếp theo khóa và giá trị, kèm theo số lượng tệp, màu sắc tùy chỉnh, biểu tượng và chức năng kéo và thả
• Tự động hiển thị tệp đang hoạt động - Mở rộng thư mục và cuộn đến lựa chọn
• Bàn phím và lệnh - Các phím tắt có thể tùy chỉnh, lệnh quay lại/tiến tới trong lịch sử chọn, lệnh chuyển sang tệp tiếp theo/trước đó, lệnh mở phím tắt 1–9

10.3. Tổ chức

• Ghim ghi chú - Giữ các ghi chú quan trọng ở đầu các thư mục và thẻ
• Ghi chú thư mục - Đặt/tháo ghi chú thư mục, ghim ghi chú thư mục, tùy chọn mở trong tab mới
• Các thao tác với thẻ - Thêm/xóa/xóa sạch thẻ, đổi tên/xóa thẻ, tạo ghi chú trong thẻ, kéo và thả để sắp xếp cấu trúc thẻ
• Sắp xếp và nhóm tùy chỉnh - Vượt qua cài đặt sắp xếp/nhóm theo từng thư mục hoặc thẻ
• Hiển thị theo thư mục/thẻ - Dòng tiêu đề, dòng xem trước, chế độ gọn nhẹ, chuyển đổi hiển thị các mục con
• Nội dung ẩn - Thư mục/thẻ/ghi chú/tệp ẩn theo mẫu, thuộc tính frontmatter và lọc theo thẻ dựa trên cấu hình kho lưu trữ
• Loại trừ các thư mục khỏi các thư mục con - Bỏ qua các thư mục khi thu thập ghi chú từ các thư mục con, theo cấu hình kho lưu trữ; các thư mục bị loại trừ vẫn hiển thị và hiển thị ghi chú của chúng khi được chọn
• Hệ thống màu sắc và biểu tượng - Màu sắc cho thư mục/thẻ/tính năng/tệp, gói biểu tượng, biểu tượng emoji/Lucide, đọc/ghi phần đầu tệp, ánh xạ biểu tượng theo tên tệp và loại tệp
• Cảnh báo tên - Cảnh báo về các ký tự hệ thống tệp bị cấm và các ký tự làm hỏng liên kết Obsidian khi đặt tên cho tệp và thư mục

9.4 Hiển thị tệp

• Xem trước ghi chú - 1–5 dòng xem trước với tùy chọn loại bỏ HTML
• Hình thu nhỏ - Hình ảnh nổi bật cùng với các hình thu nhỏ được tạo tự động cho các tệp PDF, SVG và tệp bản vẽ được lưu trữ trong bộ nhớ đệm siêu dữ liệu
• Hình ảnh bên ngoài - Tải xuống tùy chọn cho hình ảnh bên ngoài và hình thu nhỏ YouTube
• Nhóm theo ngày - Nhóm ghi chú theo Hôm nay, Hôm qua, 7 ngày trước, 30 ngày trước, tháng và năm khi sắp xếp theo ngày
• Hỗ trợ Frontmatter - Đọc tên ghi chú và dấu thời gian từ các trường Frontmatter
• Ghi chú metadata - Hiển thị ngày sửa đổi và thẻ trong danh sách tệp
• Tính năng tùy chỉnh - Hiển thị các thuộc tính frontmatter hoặc số từ trong danh sách tệp với tùy chỉnh theo thư mục/thẻ và màu sắc tùy chỉnh
• Hiển thị thư mục cha - Tùy chọn hiển thị tên và biểu tượng của thư mục cha trong danh sách tệp
• Chế độ gọn nhẹ - Hiển thị gọn nhẹ khi tắt chế độ xem trước, ngày tháng và hình ảnh
• Thẻ có thể nhấp - Các thẻ trong danh sách tệp cho phép điều hướng trực tiếp đến thẻ đó

9.5 Năng suất

• Tìm kiếm - Lọc theo tên tệp, thẻ, thuộc tính, ngày tháng, thư mục, phần mở rộng và tác vụ bằng AND/OR/loại trừ
• Tích hợp Omnisearch - Tìm kiếm toàn văn bản thông qua Omnisearch
• Kéo và thả - Di chuyển tệp, gắn thẻ, gán phím tắt, thay đổi cấu trúc thư mục thẻ, thư mục tự động mở rộng
• Menu ngữ cảnh - Tạo ghi chú/thư mục/bảng vẽ/nền/bản vẽ và thực hiện các thao tác với tệp/thẻ
• Bản vẽ - Tạo bản vẽ Excalidraw và Tldraw từ menu của thanh điều hướng và thanh danh sách
• Mẫu - Tạo ghi chú mới từ các lệnh mẫu bằng plugin Templater
• Các thao tác với tệp tin - Tạo, đổi tên, sao chép, di chuyển, xóa tệp tin và thư mục
• Lọc - Loại trừ thư mục/thẻ/ghi chú/tệp bằng mẫu và thuộc tính frontmatter

10 Thông tin về mạng và chẩn đoán

Notebook Navigator chạy trên máy cục bộ, nhưng một số tính năng sẽ gửi yêu cầu HTTP từ Obsidian. Nhật ký gỡ lỗi khi khởi động cũng có thể ghi một tệp chẩn đoán cục bộ vào kho lưu trữ của bạn.

10.1 Kiểm tra bản cập nhật (Tùy chọn)

• Cài đặt: "Kiểm tra phiên bản mới khi khởi động"
• Yêu cầu: https://api.github.com/repos/johansan/notebook-navigator/releases/latest
• Tần suất: Tối đa một lần trong vòng 24 giờ, khi khởi động
• Dữ liệu: Gửi metadata HTTP tiêu chuẩn; không bao gồm nội dung kho lưu trữ

10.2 gói biểu tượng để tải xuống (Tùy chọn)

• Cài đặt: Bật gói biểu tượng trong tab Gói biểu tượng
• Yêu cầu: https://raw.githubusercontent.com/johansan/notebook-navigator/main/icon-assets/... (danh sách tệp, phông chữ, metadata)
• Lưu trữ: Lưu trữ cục bộ trong IndexedDB

10.3 Hình ảnh, video và hình thu nhỏ trên YouTube từ nguồn bên ngoài

• Hình ảnh nổi bật (Tùy chọn): Được kiểm soát bởi cài đặt "Tải xuống hình ảnh bên ngoài". Tải xuống hình ảnh từ xa và hình thu nhỏ YouTube cho hình ảnh nổi bật và lưu trữ chúng cục bộ trong IndexedDB.
• Cửa sổ chào mừng (Lần đầu tiên mở): Tải hình thu nhỏ tĩnh từ https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/youtube-thumbnail.jpg.
• Cửa sổ thông báo mới (Khi cập nhật / khi mở): Tải hình ảnh banner từ https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.jpg cho các ghi chú phát hành có chứa banner.
• Cửa sổ thông báo “Có gì mới” (Khi cập nhật / khi mở): Tải các video thông báo phát hành từ https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.mp4 cho các ghi chú phát hành có kèm video.
• Cửa sổ bật lên “Có gì mới” (Khi mở video giới thiệu bản phát hành): Mở các video giới thiệu bản phát hành từ https://cdn.jsdelivr.net/gh/johansan/notebook-navigator@main/images/version-banners/<id>.mp4 để trình duyệt có thể phát video trực tiếp.
• Cửa sổ thông báo mới (Khi cập nhật / khi mở): Tải ảnh đại diện YouTube từ https://img.youtube.com/vi/<id>/... cho các ghi chú phát hành bao gồm liên kết YouTube.

10.4 tệp gỡ lỗi của ứng dụng khởi động (Tùy chọn)

• Cài đặt: "Ghi nhật ký gỡ lỗi khởi động"
• Lưu trữ: Ghi tệp ` nn-debug-...md ` có ghi thời gian vào thư mục gốc của kho lưu trữ, sau đó dừng lại sau khi quá trình khởi động hoàn tất. Tệp này có thể được đồng bộ hóa nếu thư mục gốc của kho lưu trữ được đồng bộ hóa.
• Dữ liệu: Bao gồm thời gian khởi động, phiên bản plugin, phiên bản Obsidian tối thiểu được hỗ trợ, nền tảng, số lượng bộ nhớ đệm, số lượng hàng đợi, trạng thái IndexedDB và các lỗi chẩn đoán. Dữ liệu này không bao gồm nội dung ghi chú, tên thẻ, giá trị phần đầu trang hoặc danh sách các tệp kho lưu trữ.
• Đường dẫn và mã định danh: Quá trình khởi động, chẩn đoán PDF và các trường hợp lỗi có thể bao gồm mã định danh ứng dụng/kho lưu trữ Obsidian, đường dẫn PDF tương đối so với kho lưu trữ hoặc chi tiết ngăn xếp lỗi. Hãy kiểm tra và che giấu thông tin nhạy cảm trong tệp trước khi chia sẻ công khai.
• Tải lên: Notebook Navigator không tải lên các tệp gỡ lỗi. Các tệp này chỉ được chia sẻ nếu bạn tải lên, đính kèm hoặc đồng bộ hóa chúng bên ngoài plugin.

11.5. Quyền riêng tư và việc xử lý dữ liệu

• Notebook Navigator không gửi nội dung ghi chú, tên tệp, thẻ hoặc tệp gỡ lỗi lên máy chủ Notebook Navigator.
• Yêu cầu gửi đến GitHub, YouTube và bất kỳ dịch vụ lưu trữ hình ảnh bên ngoài nào đều được thực hiện trực tiếp từ thiết bị của bạn và bao gồm các thông tin metadata HTTP tiêu chuẩn (địa chỉ IP, user-agent và các thông tin tương tự).
• Các gói biểu tượng và hình ảnh đã tải xuống được lưu trữ cục bộ (IndexedDB). Các ghi chú/tệp gần đây và trạng thái giao diện người dùng được lưu trữ cục bộ (Lưu trữ cục bộ của Obsidian).

11 Lịch sử ngôi sao

12 Liên hệ

Notebook Navigator được phát triển và duy trì bởi Johan Sanneblad. Johan có bằng Tiến sĩ về Phát triển Phần mềm và đã làm việc trong lĩnh vực phát triển đổi mới cho các công ty như Apple, Electronic Arts, Google, Microsoft, Lego, SKF, Volvo Cars, Volvo Group và Yamaha.

Hãy thoải mái kết nối với tôi trên LinkedIn.

13 Câu hỏi hay thắc mắc?

Tham gia Discord của chúng tôi để nhận hỗ trợ và tham gia thảo luận, hoặc mở một vấn đề trên kho lưu trữ GitHub.

Không chấp nhận các yêu cầu pull. Với sự xuất hiện của phương pháp lập trình dựa trên tác nhân (agentic coding), các bản mã được gửi từ bên ngoài không thể được kiểm soát chất lượng theo tiêu chuẩn mà dự án duy trì, do đó mọi yêu cầu pull sẽ tự động bị đóng. Thay vào đó, hãy đóng góp ý tưởng dưới dạng yêu cầu tính năng — hãy mở một issue. Xem tệp CONTRIBUTING.md để biết thêm chi tiết.

14 Giấy phép

Dự án này được cấp phép theo Giấy phép Công cộng GNU phiên bản 3.0 - xem tệp LICENSE để biết chi tiết.