Tóm tắt nhanh:
ak-markdown-novel-viewermở một file hoặc thư mục markdown (RFC, runbook, báo cáo, plan) trong trang đọc kiểu sách chạy trên máy bạn, rồi trả đúng URL server in ra. Đọc xong, nó chỉ tắt server do chính nó mở. Nó không tạo file HTML để gửi đi: việc đó thuộc vềak-preview --html.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn có tài liệu markdown dài, một thư mục tài liệu, hay một plan nhiều phase và muốn đọc trên trình duyệt thay vì cuộn trong terminal. Không cần khi bạn muốn một file HTML độc lập để gửi cho người khác.
flowchart LR
A["File hoặc thư mục markdown"] --> B["ak-markdown-novel-viewer"]
B --> C["URL trang đọc trên localhost"]
C --> D["Bạn đọc trên trình duyệt"]
D --> E["Tắt server của lần chạy này"]
A -.->|"Cần file HTML độc lập"| F["ak-preview --html"]Bốn khái niệm cần nắm:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| File hay thư mục | Bạn đưa cho nó cái gì? | docs/rfc-042.md mở thẳng trang đọc; docs/ mở danh sách file và thư mục con |
| Thư mục plan | Khi nào trang đọc có sidebar và nút Trước, Sau? | Mở plan.md trong thư mục có các file phase: sidebar liệt kê phase kèm trạng thái |
| URL thật, không đoán port | Trang mở ở địa chỉ nào? | Port 3456 bận thì server nhảy sang port trống kế tiếp; skill trả đúng URL server in ra |
| Server của ai, người đó tắt | Ai tắt server, và tắt cái nào? | Skill ghi PID, port, project của server nó mở và chỉ tắt đúng PID đó |
Mặc định server chỉ nghe trên localhost; muốn mở từ điện thoại hay máy khác cùng mạng thì nói rõ trong prompt.
Prompt mẫu cho đọc một tài liệu dài:
/ak-markdown-novel-viewer docs/<tên tài liệu>.mdSkill này không có cờ. Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-markdown-novel-viewer: đọc markdown dài trong trang kiểu sách" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-markdown-novel-viewer". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-markdown-novel-viewer
