Logseq Doctor: Công cụ dòng lệnh giúp "chữa lành" file Markdown trước khi nhập vào Logseq

Logseq là một ứng dụng ghi chú dựa trên kiến thức (knowledge base) phổ biến, sử dụng định dạng outline (đại cương) thay vì văn bản tuyến tính. Tuy nhiên, việc nhập các file Markdown "phẳng" (flat) từ các nguồn khác vào Logseq thường gặp khó khăn do sự khác biệt về cấu trúc. Logseq Doctor ra đời như một giải pháp để giải quyết vấn đề này.

Trạng thái tài liệu

Logseq Doctor là gì?

Logseq Doctor là một công cụ dòng lệnh (CLI) được thiết kế để thao tác và xử lý các file Markdown của Logseq. Công cụ này cung cấp các tiện ích giúp người dùng chuyển đổi dữ liệu, quản lý tác vụ và làm sạch file Markdown một cách tự động.

Hiện tại, dự án vẫn đang ở giai đoạn Alpha, nên tính năng và tài liệu có thể còn sơ khai. Đáng chú ý, dự án đang trong quá trình chuyển đổi mã nguồn từ Python sang Go để tối ưu hóa tốc độ và hiệu suất trong tương lai.

Trạng thái build Go

Các tính năng nổi bật

Logseq Doctor cung cấp bộ lệnh phong phú để tương tác với đồ thị (graph) Logseq của bạn:

• Quản lý Backlog (backlog): Tổng hợp các tác vụ từ nhiều trang khác nhau thành một backlog thống nhất. Tính năng này hỗ trợ phân loại thông minh, phát hiện các task quá hạn và tạo trang tập trung (focus page).
• Quản lý nội dung (content): Nối thêm nội dung Markdown thô vào các trang hoặc nhật ký (journals) trong Logseq.
• Tích hợp Markdown (md): Phân tích và thêm nội dung Markdown bằng cách thao tác DOM, hỗ trợ các khối cha (parent blocks) và nhắm mục tiêu đến nhật ký cụ thể.
• Quản lý tác vụ (task): Thêm tác vụ mới hoặc cập nhật tác vụ hiện có thông qua tìm kiếm dựa trên khóa, đồng thời giữ nguyên các mục con và thuộc tính.
• Dọn dẹp (tidy-up): Làm sạch và chuẩn hóa các file Markdown của bạn, đảm bảo tuân thủ định dạng chuẩn.
• Chuyển đổi Outline (outline): Chuyển đổi các file Markdown phẳng sang định dạng outline đặc trưng của Logseq.

Phiên bản Python

Cài đặt

Dự án cung cấp hai phiên bản thực thi: Go (khuyên dùng) và Python.

Sử dụng Go Binary (Khuyên dùng)

Đối với người dùng macOS và Linux, cách cài đặt đơn giản nhất là sử dụng Homebrew:

brew install andreoliwa/formulae/logseq-doctor

Hoặc cài đặt thủ công thông qua Go:

go install github.com/andreoliwa/logseq-doctor/cmd/lqd@latest

Sau khi cài đặt, bạn có thể kiểm tra bằng lệnh which lqd.

Sử dụng Python

Bạn có thể cài đặt phiên bản Python bằng pipx:

pipx install logseq-doctor

Lệnh lqdpy sẽ có sẵn toàn cục trên hệ thống của bạn.

Cách sử dụng cơ bản

Sau khi cài đặt, bạn có thể chạy lqd (phiên bản Go) hoặc lqdpy (phiên bản Python) để xem danh sách các lệnh khả dụng.

Ví dụ, để chuyển đổi file Markdown phẳng sang định dạng outline:

lqd outline

Để tổng hợp các task vào backlog:

lqd backlog

Logseq Doctor là một công cụ hỗ trợ đắc lực cho những ai muốn chuyển đổi sang Logseq mà không muốn mất thời gian chỉnh sửa thủ công hàng loạt file Markdown cũ. Với sự chuyển dịch sang ngôn ngữ Go, công cụ này hứa hẹn sẽ xử lý dữ liệu nhanh chóng và hiệu quả hơn trong tương lai.