SSkilnexa
SkillKỹ thuật phần mềmHợp với: Người viết tài liệuMức: Vừa

Đổi tài liệu Markdown dài thành HTML có mục lục

md-document

Biến đặc tả, RFC, báo cáo thành một tệp HTML có mục lục cố định, tìm kiếm, nút sao chép mã và màu theo hệ thống thiết kế. Phải chạy bước thiết lập thiết kế trước.

Tải miễn phí. Theo dõi Skilnexa một lần là mở khoá mọi lượt tải trên web.

Nút theo dõi đang được chuẩn bị.
Link tải đang được chuẩn bị.

Nó là gì

Đổi tài liệu Markdown dài (đặc tả, báo cáo, kế hoạch) thành một file HTML có mục lục, ô tìm kiếm và nút sao chép code. Khác mở file Markdown gốc: trang HTML dễ đọc, chia mục rõ, mang màu thương hiệu đã cài.

Hoạt động ra sao

Bạn chạy ba bước: đọc Markdown thành cấu trúc, dựng HTML theo cấu hình thương hiệu, rồi thêm tính năng tìm kiếm, mục lục cuộn theo vị trí và nút sao chép. Trước khi dựng, nên xác định người đọc sẽ lướt, quyết định hay đọc kỹ. Kết quả là file doc-<tên>.html trong thư mục đã cấu hình.

Ví dụ ứng dụng

Tình huống
Kiến trúc sư viết đặc tả nội thất căn hộ 120 m2 dài hơn 150 dòng, cần gửi chủ nhà đọc trên điện thoại.
Bạn đưa vào
File ban-dac-ta-noi-that.md và cấu hình thương hiệu đã cài đặt một lần.
Bạn nhận được
File doc-ban-dac-ta-noi-that.html có mục lục, ô tìm kiếm và nút sao chép lệnh.

Ví dụ minh họa theo quy trình trong tài liệu gốc, chưa phải kết quả thử chạy.

Dùng khi nào

Khi cần xuất bản báo cáo Markdown thành trang xem được trong trình duyệt.

Các phần chính trong hướng dẫn

  1. Khi nào dùng
  2. Quy trình xử lý
  3. Nội dung được dựng ra
  4. Quy tắc bắt buộc
  5. Tệp đầu ra
Xem mô tả gốc của tác giả (tiếng Anh)

Converts long-form markdown (specs, RFCs, reports, plans, explainers) into a single-file, lightly-interactive HTML document with sticky TOC, scrollspy, search filter, code-copy buttons, and design-system-driven brand tokens. Triggers when the markdown-html-orchestrator classifies an input as DOCUMENT, or when invoked directly via /cs:md-document. Reads the design-system config via config_loader.py and inlines the user's 12 derived CSS custom properties; refuses to render if onboarding hasn't run. Single-file output — Google Fonts + Prism.js CDN are the only externals; no framework runtime, no build step. Use after orchestrator routing or after design-system onboarding is confirmed.

Chi tiết tính năng

  • {default_output_dir}/doc-{slug}.html (path resolved by orchestrator's output_path_resolver.py; collision suffix -2, -3, … by default).

Cùng nhóm Kỹ thuật phần mềm

Phần giải thích do Skilnexa viết sau khi đọc toàn bộ tài liệu gốc của tác giả và đã đối chiếu lại với nội dung gốc. Chưa phải kết quả thử chạy, nên hãy thử bằng dữ liệu giả trước khi dùng cho việc thật.