📑

Markdown TOC Generator (Mục lục tự động)

Sinh Table of Contents từ markdown — anchor link tương thích GitHub. Bỏ dấu tiếng Việt, numbered list, checklist. Phù hợp README, docs, blog dài.

Markdown

TOC

Tùy chọn

Cấp tối thiểu Cấp tối đa Kiểu Indent (spaces)

Bỏ dấu tiếng Việt trong anchor link Thêm số thứ tự (1.1, 1.2, 2.1...)

Sinh Table of Contents (mục lục) từ markdown — thường dùng cho README, docs, blog dài. Anchor link tương thích GitHub/GitLab/Hugo/Astro slug rules.

Khi nào cần TOC?

README dự án: file dài → người đọc nhảy nhanh tới phần cần.
Docs site: Astro/Docusaurus auto-sinh TOC, nhưng GitLab/GitHub markdown chưa — phải thêm tay.
Blog post dài: bài 3000+ từ — TOC ở đầu giúp navigation, tăng dwell time SEO.
Notion / Obsidian: paste markdown export — auto sinh outline.

GitHub/GitLab convert heading sang slug:

Lowercase tất cả.
Khoảng trắng → dấu gạch nối.
Strip ký tự đặc biệt (? ! : ...).
Strip diacritics — TIẾNG VIỆT có dấu sẽ bị trở thành slug có dấu nếu không strip!
Heading trùng → thêm hậu tố -1, -2...

Bỏ dấu tiếng Việt: bật để slug ASCII clean — tương thích cả GitHub và Hugo. Ví dụ "Cài đặt" → #cai-dat (KHÔNG phải #cài-đặt).
Min/max level: H2-H3 thường đủ. H1 thường là tiêu đề bài → bỏ. H4-H6 quá chi tiết.
Numbered + checklist: phù hợp tutorial dạng step-by-step (v.d. "Cài đặt", "Cấu hình", "Chạy").
Code blocks: tool tự skip headings trong fenced code block ``` — không nhầm # comment trong code.