Liên kết & hình ảnh Markdown

Kiểm tra mọi liên kết và hình ảnh trong README hay bất kỳ tài liệu Markdown nào. Công cụ liệt kê chúng thành bảng kèm số dòng, URL, tiêu đề và đích, đánh dấu neo hỏng, tham chiếu chưa định nghĩa cùng các lỗi khác, xuất danh sách, và chuyển liên kết inline sang kiểu tham chiếu hoặc ngược lại. 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, Bài blog, HTML bài viết blog) và Xoá. Bạn cũng có thể kéo thả file .md vào ô.
2. Xem bảng Liên kết & hình ảnh. Mỗi dòng cho biết số dòng, loại (liên kết, hình ảnh hay định nghĩa, và cách viết), chữ hoặc alt, URL, tiêu đề, đích (neo nội bộ, đường dẫn tương đối hay địa chỉ bên ngoài) và trạng thái.
3. Thu hẹp bảng bằng Tất cả, Liên kết, Hình ảnh hoặc Có vấn đề, hay gõ vào ô tìm kiếm. Bấm con số ở cột Dòng để chọn đúng liên kết đó trong ô Markdown.
4. Bên phải, Xuất chuyển các dòng đang hiện trong bảng thành CSV, JSON, Danh sách Markdown hoặc Danh sách URL — bật Bỏ URL trùng để mỗi địa chỉ chỉ xuất hiện một lần. Bấm Sao chép hoặc nút tải về.
5. Để viết lại tài liệu, chọn Inline → tham chiếu, chọn Tên tham chiếu (Đánh số hoặc Theo chữ liên kết), rồi bấm Sao chép tài liệu hay Tải .md. Tham chiếu → inline làm điều ngược lại và xoá các định nghĩa đã dùng.

Mẹo

• Neo hỏng là một liên kết #neo không khớp tiêu đề nào, cũng không khớp id hay name HTML nào trong tài liệu. Neo theo quy tắc của GitHub (tiêu đề trùng thành -1, -2), neo đã mã hoá phần trăm được giải mã trước khi so, còn # và #top luôn được coi là hợp lệ.
• Tham chiếu chưa định nghĩa được báo cho [chữ][nhãn] và [chữ][] khi không có dòng [nhãn]: url. Một [chữ] đứng riêng mà không có định nghĩa chỉ là chữ thường, nên ô công việc như [x] không bao giờ bị báo.
• Định nghĩa không dùng đánh dấu dòng [nhãn]: url không được dùng đến, hoặc nhãn bị định nghĩa hai lần (định nghĩa đầu tiên được dùng). URL trùng đánh dấu địa chỉ được liên kết từ nhiều chỗ — các tham chiếu dùng chung một định nghĩa chỉ tính một lần.
• URL trống bắt lỗi [chữ](), còn http (không phải https) bắt địa chỉ không an toàn; localhost không bị báo.
• Liên kết trong khối code rào hoặc thụt lề, code inline và chú thích HTML được bỏ qua. Thẻ HTML <a href> và <img src>, autolink <https://…> và địa chỉ trần https://… hay www. cũng được liệt kê.
• Nhãn được so khớp không phân biệt hoa thường và bỏ qua khoảng trắng thừa, nên [Guide][] dùng được định nghĩa [guide]: ….

Khi chuyển sang kiểu tham chiếu, liên kết và hình ảnh cùng URL và tiêu đề dùng chung một định nghĩa, định nghĩa sẵn có cho URL đó được dùng lại, và tên mới không bao giờ trùng với nhãn hay đoạn chữ trong ngoặc vuông đã có trong tài liệu, ví dụ [1]. Phần còn lại giữ nguyên, kể cả kiểu xuống dòng Windows (CRLF).

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

Công cụ có kiểm tra liên kết bên ngoài còn hoạt động không?

Không. Việc kiểm tra chỉ dựa trên chính tài liệu: neo so với tiêu đề, tham chiếu so với định nghĩa. Muốn thử các địa chỉ, hãy dùng bản xuất Danh sách URL với một công cụ kiểm tra liên kết.

Công cụ theo quy tắc Markdown nào?

CommonMark kèm phần mở rộng của GitHub, đúng quy tắc GitHub dùng cho README. Ví dụ, liên kết viết bên trong chữ của một liên kết khác chỉ giữ liên kết bên trong, và địa chỉ trần bắt đầu bằng http://, https:// hay www. được tính là liên kết.

Chuyển đổi có làm tài liệu hiển thị khác đi không?

Không. Liên kết inline và liên kết tham chiếu hiển thị như nhau; chỉ phần mã nguồn thay đổi. Tham chiếu chưa định nghĩa và định nghĩa không dùng được giữ nguyên để bạn tự sửa.

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

Không. Liên kết được trích xuất và chuyển đổi ngay trên trình duyệt của bạn.