Trình tạo Mục lục Markdown

Công cụ miễn phí tự động tạo Mục lục (TOC - Table of Contents) cho các tài liệu viết bằng Markdown. Nó giúp bạn tiết kiệm công sức tạo mục lục thủ công khi viết các bài viết kỹ thuật trên các nền tảng như GitHub README hoặc blog.

Bạn có thể tinh chỉnh phạm vi trích xuất của các cấp độ tiêu đề (h1-h6) và định dạng đầu ra, chẳng hạn như danh sách không theo thứ tự (-) hoặc danh sách theo thứ tự (1.).

Tất cả quá trình xử lý được hoàn tất trong trình duyệt của bạn, vì vậy dữ liệu văn bản bạn nhập sẽ không bao giờ được gửi đến máy chủ bên ngoài. Bạn có thể yên tâm sử dụng cho các tài liệu bảo mật hoặc ghi chú riêng tư mà không lo rò rỉ thông tin.

Markdown

Là một ngôn ngữ đánh dấu nhẹ dùng để định dạng văn bản. Nó sử dụng các ký hiệu để dễ dàng biểu thị tiêu đề, danh sách, liên kết, v.v., và được sử dụng rộng rãi, đặc biệt là trong giới lập trình viên.

TOC (Table of Contents)

Được đặt ở đầu một tài liệu dài, nó cho phép người đọc truy cập nhanh vào phần họ muốn, giúp cải thiện khả năng đọc.

Cấp độ Tiêu đề

Một chỉ báo về cấu trúc phân cấp của tài liệu, tương ứng với các thẻ từ h1 đến h6 của HTML. Trong Markdown, cấp độ được thể hiện bằng số lượng ký tự "#".

Liên kết Neo

Một liên kết dùng để nhảy đến một vị trí cụ thể trong cùng một trang. Trong Mục lục Markdown, nó chuyển hướng bằng cách chỉ định một ID được tạo tự động (ví dụ: `#heading`) dựa trên văn bản của tiêu đề.

Xử lý phía Máy khách

Cơ chế chạy chương trình chỉ bên trong trình duyệt của người dùng mà không cần giao tiếp với máy chủ. Cơ chế này không có rủi ro rò rỉ dữ liệu và mang lại tính bảo mật tuyệt vời.

Q.Dữ liệu Markdown tôi nhập có được lưu trên máy chủ không?

Không, dữ liệu không được lưu. Công cụ này sử dụng xử lý phía máy khách (client-side) chạy hoàn toàn trong trình duyệt của bạn, văn bản bạn nhập sẽ không bao giờ được gửi đến máy chủ bên ngoài. Bạn có thể sử dụng an toàn ngay cả với các tài liệu chứa thông tin bảo mật.

Q.Nhấp vào liên kết mục lục (TOC) được tạo không di chuyển đến đúng vị trí.

Tùy thuộc vào nền tảng (GitHub, v.v.), các quy tắc tự động tạo ID liên kết từ tiêu đề có thể khác nhau. Công cụ này tạo ID dựa trên các quy tắc phổ biến (chữ thường, thay thế khoảng trắng bằng dấu gạch ngang, v.v.), nhưng bạn có thể cần chỉnh sửa thủ công để phù hợp với thông số kỹ thuật cụ thể của nền tảng.

Q.Tôi có thể loại trừ một tiêu đề cụ thể khỏi TOC không?

Trong phiên bản hiện tại, tất cả các tiêu đề thấp hơn 'Cấp độ Tối đa' đã chỉ định sẽ được trích xuất. Không có tính năng loại trừ các tiêu đề cụ thể, vì vậy vui lòng xóa chúng thủ công sau khi tạo.

Q.Các ký tự '#' bên trong khối mã (code block) có bị trích xuất không?

Không, thuật toán trích xuất của công cụ chúng tôi được thiết kế để bỏ qua văn bản bên trong các khối mã được bao quanh bởi ba dấu ngoặc kép (```). Do đó, các bình luận bên trong mã sẽ không bị trích xuất nhầm thành TOC.

Q.Công cụ có hỗ trợ các tiêu đề không phải tiếng Anh không?

Có. Các tiêu đề bằng tiếng Nhật, tiếng Anh và các ngôn ngữ khác sẽ được trích xuất chính xác và tạo thành TOC. Tuy nhiên, vì quy tắc tạo ID liên kết neo dựa trên tiếng Anh, các tiêu đề không phải tiếng Anh có thể được mã hóa URL trong một số trường hợp.