Công cụ tiêu đề Markdown

Sửa tiêu đề của README, báo cáo hay bất kỳ tài liệu Markdown nào ở cùng một chỗ. Thêm số mục kiểu 1., 1.1, 1.1.1, bỏ số đi, nâng hoặc hạ cấp toàn bộ tiêu đề, dọn cú pháp tiêu đề và kiểm tra dàn ý tìm cấp bị nhảy, H1 thừa và neo liên kết trùng. Mọi thứ chạy ngay trên trình duyệt.

Các bước sử dụng

1. Dán Markdown vào ô Markdown, hoặc dùng thanh nhập liệu ở đầu ô: Mở file, Dán, Dữ liệu mẫu (Ví dụ của công cụ này, README, Tài liệu API có bảng & code, Biên bản họp, Bài blog) và Xoá. Bạn cũng có thể kéo thả file .md vào ô.
2. Chọn thao tác ở phía trên:
   • Đánh số — chọn Kiểu số (1.1., 1.1, 1-1, hoặc I. / A. cho cấp cao nhất), Bắt đầu từ (chọn H2 để tiêu đề H1 không bị đánh số), Độ sâu, ký tự Sau số (Dấu cách, Dấu chấm hoặc Gạch ngang), và liệt kê các tiêu đề cần Bỏ qua tiêu đề như "Mục lục".
   • Bỏ đánh số — xoá tiền tố 1., 1.2.3, 2-1 và IV.. Bật Bỏ cả chữ cái và số trơn nếu tài liệu đánh số kiểu A. hoặc 1 Giới thiệu.
   • Đổi cấp — ở Thao tác chọn Hạ cấp (H2 → H3) hoặc Nâng cấp (H3 → H2) theo Số cấp, hoặc Tiêu đề cao nhất thành H1 / Tiêu đề cao nhất thành H2 để khớp một đoạn vừa dán với tài liệu của bạn.
   • Chuẩn hoá cú pháp — Setext → # chuyển tiêu đề gạch chân === / ---, Bỏ # đóng xoá dấu thăng ở cuối, Một dấu cách sau # chỉnh khoảng trắng, và Dòng trống quanh tiêu đề thêm dòng trống mà một số trình hiển thị cần.
   • Kiểm tra — liệt kê các vấn đề; chỉnh Phải bắt đầu bằng H1 và Độ dài tối đa (0 = tắt) theo quy ước của bạn.
3. Giữ bật Cập nhật mục lục nếu tài liệu có khối <!-- toc -->, để liên kết trong mục lục theo kịp chữ tiêu đề mới.
4. Xem khung bên phải: Kết quả hiện Markdown mới, Dàn ý hiện cây tiêu đề kèm neo liên kết, Xem trước dựng tài liệu. Ở chế độ Kiểm tra, thẻ Vấn đề liệt kê từng lỗi kèm số dòng — bấm vào một lỗi để chọn đúng dòng đó trong ô nhập.
5. Bấm Sao chép Markdown hoặc Tải .md, hay Sao chép báo cáo để lấy kết quả kiểm tra.

Mẹo

• Khi đánh số, số cũ luôn được xoá trước, nên bạn cứ sửa, thêm hay đổi thứ tự mục rồi đánh số lại — không tiêu đề nào bị đánh số hai lần.
• Cấp bị nhảy được đánh số theo quan hệ cha con: H4 nằm ngay dưới H2 thành 1.1, không phải 1.0.1.
• Tiêu đề gạch chân --- / === mà có số dạng 1. đứng đầu sẽ được viết lại bằng #, vì 1. Tiêu đề nằm trên dòng --- sẽ bị hiểu thành danh sách đánh số.
• Tiêu đề trong khối code (rào hoặc thụt lề), khối HTML và YAML front matter không bao giờ bị sửa, kiểu xuống dòng Windows (CRLF) được giữ nguyên.
• Dòng #hashtag không phải tiêu đề. Dòng như ##TiêuĐề thiếu dấu cách cũng không phải tiêu đề — Kiểm tra sẽ chỉ ra.
• Tiêu đề như 2024 nhìn lại hay C. Elegans được Bỏ đánh số giữ nguyên; chỉ bật Bỏ cả chữ cái và số trơn khi tài liệu thật sự đánh số kiểu đó.

Thêm số làm đổi neo liên kết của mọi tiêu đề, ví dụ #giới-thiệu thành #1-giới-thiệu. Khi bật Cập nhật mục lục, mục lục tạo bằng công cụ Tạo mục lục Markdown được dựng lại với đúng thiết lập cũ, nên liên kết vẫn chạy.

Câu hỏi thường gặp

Đánh số xử lý tiêu đề H1 thế nào?

Chọn Bắt đầu từ là H2. H1 giữ nguyên, các mục H2 được đánh 1, 2, 3. Nếu tài liệu có nhiều H1, mỗi H1 đóng các mục đang mở và số tiếp tục ở số cấp cao nhất kế tiếp.

Chuyện gì xảy ra khi đổi cấp vượt quá H1 hoặc H6?

Cấp được giới hạn trong H1–H6, và một cảnh báo nêu rõ những cấp đã bị gộp, để bạn dán lại bản gốc nếu muốn làm lại.

Tài liệu của tôi có bị tải lên không?

Không. Mọi thao tác và kiểm tra tiêu đề đều chạy ngay trên trình duyệt của bạn.