Trình xem và sửa CLAUDE.md

Vì sao file hướng dẫn của AI xứng đáng có một trình xem tử tế

Các trợ lý lập trình được điều hướng bằng Markdown. CLAUDE.md cho Claude Code biết dự án build thế nào và cần tránh gì; AGENTS.md làm việc tương tự cho các agent lập trình khác; SKILL.md đóng gói một skill dùng lại được; GEMINI.md, tài liệu kế hoạch và ghi chú thiết kế cũng theo cùng mô hình. Chúng được viết dưới dạng văn bản, nhưng chứa đầy cấu trúc: danh sách quy tắc lồng nhau, bảng lệnh, đoạn shell trong khối mã, cảnh báo, liên kết tới các file khác. Đọc ở dạng văn bản thô thì rất mệt, và một dấu sao lạc hay một khối mã chưa đóng có thể âm thầm làm thay đổi cách hiểu tài liệu.

Mở một file ở đây và bạn thấy đúng điều tác giả muốn: tiêu đề điều hướng được từ dàn ý, danh sách quy tắc thụt lề đúng, bảng có cột thẳng hàng, lệnh trong khối mã sao chép được bằng một cú bấm, và khung > [!WARNING] nổi bật. Đây là cách nhanh để rà soát file hướng dẫn trước khi commit, hoặc đọc một kế hoạch dài mà agent viết cho bạn trước khi bạn duyệt.

Mở và đọc AGENTS.md, SKILL.md và file kế hoạch

• Từ ổ đĩa: dùng Mở → Mở tệp… hoặc kéo file vào trang. File hướng dẫn dự án thường nằm ở thư mục gốc kho mã; skill nằm trong các thư mục bạn tìm tới được bằng hộp thoại chọn file (hãy hiện thư mục ẩn nếu đường dẫn bắt đầu bằng dấu chấm).
• Từ kho mã: dán liên kết GitHub của file vào Mở → Từ URL…. Mọi file Markdown công khai đều dùng được, tối đa 2 MB.
• Từ terminal hoặc chat: sao chép câu trả lời của agent rồi dán vào trình soạn thảo. Bảng, mã và sơ đồ hiển thị ngay, và bạn có thể xuất kết quả ra HTML hoặc PDF.

Với SKILL.md, front matter YAML nằm giữa hai dòng --- được hiện thành khối riêng phía trên phần nội dung, nên dễ kiểm tra tên và mô tả. Trình xem không kiểm tra tính hợp lệ của skill — nó chỉ cho bạn thấy văn bản, đã được hiển thị.

Sơ đồ, bảng và khung cảnh báo, đã hiển thị

Agent thích giải thích kiến trúc bằng sơ đồ Mermaid: một khối mermaid trở thành lưu đồ, sơ đồ tuần tự, sơ đồ lớp, máy trạng thái hay biểu đồ Gantt ngay trong bản xem trước (trang Mermaid live editor liệt kê các loại sơ đồ). Bảng tùy chọn hay endpoint hiện thành bảng thật, danh sách công việc có ô đánh dấu, công thức giữa hai dấu đô la được sắp chữ bằng KaTeX, và khối mã được tô sáng cho hơn 50 ngôn ngữ với tên ngôn ngữ ở phần đầu. HTML nội tuyến được làm sạch trước khi lên trang, nên một tài liệu bạn không tự viết cũng không thể chạy script ở đây.

Sửa với xem trước trực tiếp, rồi lưu lại

Chuyển sang bố cục Chia đôi để chỉnh một file hướng dẫn với kết quả đã hiển thị nằm cạnh mã nguồn. Trình soạn thảo có thanh công cụ định dạng, phím tắt, tự tiếp tục danh sách và thụt lề bằng Tab, còn bản xem trước cuộn theo đúng dòng bạn đang sửa — hữu ích với file dài, nơi một gạch đầu dòng thụt sai cũng đổi nghĩa. Khi xong, Xuất → Tải xuống .md cho bạn file để thả lại vào thư mục dự án, và Sao chép Markdown đưa văn bản vào clipboard. Mười sáu giao diện sáng và tối, gồm cả giao diện Claude với tiêu đề dùng phông có chân, giúp bạn chọn kiểu đọc hợp với tài liệu dài.

Mới làm quen cú pháp? Bảng cú pháp Markdown gói gọn trên một trang, và hướng dẫn file MD giải thích cách mở bất kỳ file .md nào trên Windows, Mac hay điện thoại.

Hướng dẫn dự án của bạn vẫn riêng tư

File hướng dẫn và kế hoạch thường nhắc tới công cụ, đường dẫn và quy ước nội bộ. Markdown Viewer hiển thị mọi thứ bằng JavaScript trong trình duyệt và lưu tài liệu trong bộ nhớ cục bộ trên thiết bị của bạn; không có tài khoản và không có bản sao trên máy chủ. Mở một liên kết là thao tác duy nhất cần tới máy chủ của chúng tôi, và lần tải đó không được lưu hay ghi log. Xem trang quyền riêng tư để biết chi tiết, hoặc mở trình xem Markdown chính để bắt đầu đọc.