Markdown TOC
Markdown TOC — chạy trên trình duyệt. Không lưu dữ liệu.
Tạo mục lục Markdown
Nhập giá trị, rồi nhấn Tính.
Cách sử dụng
- Dán thân vào ô Markdown. Tài liệu cần tiêu đề ATX (# tiêu đề).
- Chọn Cấp tối thiểu và Cấp tối đa. Mặc định H2 đến H4.
- Nhấn Tạo TOC thì danh thụt và liên kết neo được tạo.
- Sao chép lên đầu README hoặc wiki. Có thể xóa nhập bằng Đặt lại.
- # trong khối mã không được phân biệt, nên tiêu đề kiểu chú thích lẫn TOC thì sửa thân.
Khái niệm chính
Markdown TOC dùng khi làm nhanh liên kết mục lục trên GitHub README, blog kỹ thuật, site tài liệu. Tìm # đến ###### từng dòng và chỉ xuất cấp đã chọn dạng - [tiêu đề](#slug). Slug viết thường, khoảng thành gạch nối, giữ Hangul. Tiêu đề lặp thêm -2, -3. Là trình tạo Markdown TOC làm mục lục README GitHub, thanh bên wiki, liên kết nhảy tài liệu chỉ từ tiêu đề ATX.
Tiêu đề Setext gạch dưới (===, ---) không nhận. Quy tắc neo có thể không khớp 100% GitHub hay một số bộ tạo site tĩnh, click không chạy trên xem trước thì kiểm quy tắc renderer. Chuyển chỉ trong trình duyệt. Cấp min/max có thể bỏ tiêu đề H1 và chỉ gồm H2–H4. # trong hàng rào mã có thể bị nhầm tiêu đề.
Ví dụ
Thân có ## Cài đặt, ### Yêu cầu, ## Cách dùng, tạo min H2 max H4: Cài đặt và Cách dùng cùng thụt, Yêu cầu thụt một cấp. Liên kết là slug giữ tiêu đề Hangul như #설치, #요구-사항. Chỉ có H1 mà min là H2 thì mục lục có thể trống. Đặt ## Bắt đầu và ### Cài đặt thì Cài đặt nằm dưới Bắt đầu một bậc, liên kết #시작하기, #설치.
Liên quan: Xem trước Markdown · Markdown → HTML
Câu hỏi thường gặp
Tiêu đề Setext (===) cũng vào Markdown TOC?
Không. Chỉ hỗ trợ kiểu # (ATX). Tiêu đề gạch dưới Setext không vào mục lục, hãy thêm #.
Slug neo tiêu đề Hangul ra sao?
Giữ Hangul và đổi khoảng thành gạch nối. Renderer có thể khác. Site tĩnh neo Hangul vỡ hãy kiểm quy tắc plugin slug.
Chú thích # trong khối mã có bị TOC bắt?
Phân tích từng dòng đơn giản, không phân biệt khối mã. # TODO chú thích lẫn TOC thì bỏ khỏi thân.
Giống mục lục README GitHub?
Tương tự nhưng bỏ ký tự đặc biệt và quy tắc trùng có thể không khớp hoàn hảo. Quy tắc bỏ ký tự đặc biệt GitHub có thể khác, hãy thử click trên xem trước.
Khi nào dùng cấp tiêu đề min/max?
Dùng mặc định khi bỏ tiêu đề tài liệu (H1) và chỉ đưa H2–H4 vào mục lục. Muốn gồm từ H1 thì đổi cấp tối thiểu thành H1.
Cùng tiêu đề hai lần thì neo trùng?
Từ lần hai, số như -2 gắn sau slug. Cùng tiêu đề thì liên kết thứ hai có -2 để tránh đụng.
Cập nhật lần cuối: 2026-09-04