Marksmith - Tiện ích mở rộng tăng năng suất Markdown cho VS Code/Windsurf

(rakkunn.github.io)

2 điểm bởi woojinim64 1 ngày trước | Chưa có bình luận nào. | Chia sẻ qua WhatsApp

Tiện ích mở rộng được tạo ra để giảm bớt các thao tác lặt vặt khi viết Markdown trong VS Code và Windsurf

Tích hợp nhận diện ngữ cảnh clipboard, preview hai chiều và phân tích tài liệu vào một gói duy nhất
Vì Windsurf dựa trên nhánh fork của VS Code nên hỗ trợ cả hai bằng cùng một API

Lý do tạo ra

Nội dung sao chép từ web/Word thường bị đưa vào dưới dạng HTML lỗi hoặc plain text
Phải phụ thuộc vào các trang chuyển đổi bên ngoài khi nhập dữ liệu bảng
Tốn công dò cuộn do thiếu đồng bộ vị trí giữa preview và editor

Tính năng chính

Smart Paste

HTML → Markdown: áp dụng override rule cho bảng GFM và code block trên engine Turndown
Tự động chuyển đổi TSV: thay thế bảng sao chép từ Excel/Google Sheets thành bảng Markdown bằng pipeline dựa trên regex
Khi dán URL lên đoạn văn bản đã chọn, tự động bọc theo dạng selected

Bi-directional Preview

Render lại toàn bộ khi có thay đổi → gây nhấp nháy KaTeX và nhảy cuộn
Đã chuyển sang phương thức cập nhật tăng dần (incremental DOM patch)
Tiêm thuộc tính data-line vào từng node HTML ở bước compile để ánh xạ với dòng nguồn
Khi nhấp vào preview, gửi số dòng tới editor qua postMessage → di chuyển con trỏ

Document X-Ray (bảng điều khiển sidebar)

Ước tính số ký tự/thời gian đọc cho tài liệu trộn tiếng Hàn-tiếng Anh (chuẩn 200 wpm cho tiếng Anh, 500 ký tự/phút cho tiếng Hàn)
Outline dựa trên phân tích cây heading + điều hướng bằng nhấp chuột
Kiểm tra tình trạng 404 bất đồng bộ cho các liên kết ngoài trong tài liệu

Phạm vi hỗ trợ hiện tại

Tích hợp linter/formatter
Render KaTeX, Mermaid
Xuất HTML/PDF

Kế hoạch sắp tới

Tối ưu hiệu năng cho tài liệu lớn (incremental parsing)
Tích hợp AI assist (tóm tắt, chỉnh sửa câu văn)
Chế độ tương thích với Obsidian Vault

Ghi chú kỹ thuật

Webview của VS Code Extension API là sandbox tách biệt khỏi editor
Nếu không có debouncing và message batching khi giao tiếp hai chiều thì tài liệu lớn sẽ bị giảm hiệu năng
Tùy theo thiết kế kiến trúc mà ngay cả cùng chức năng cũng có thể chênh lệch hiệu năng lớn

Liên kết

GitHub: https://github.com/RAKKUNN/Marksmith
Page: https://rakkunn.github.io/MarkSmith/

Rất mong nhận được nhiều phản hồi và review!!
Xin cảm ơn.