Lấy cấu trúc tài liệu thay vì sao chép bố cục trang web
Dùng HTML đã lưu hoặc sao chép để tạo bản nháp dễ đọc cho tài liệu hướng dẫn hoặc kho mã. Công cụ giữ lại tiêu đề, liên kết, danh sách và bảng thông thường, đồng thời loại bỏ tập lệnh và kiểu trang. Bạn có thể kiểm tra Markdown được tạo trước khi lưu.
Đây là công cụ chuyển HTML sang Markdown, không phải trình thu thập dữ liệu trang web. Hãy dán mã nguồn hoặc mở tệp HTML. URL trang web, ảnh chụp màn hình và PDF là các đầu vào khác mà công cụ không tải về hoặc phân tích.
Những gì được giữ lại khi chuyển HTML
Các thành phần tài liệu cơ bản
Tiêu đề, chữ nhấn mạnh, liên kết, danh sách, trích dẫn và khối mã cơ bản được chuyển thành cú pháp Markdown tương ứng.
Bảng trở thành mã nguồn có thể chỉnh sửa
Bảng HTML đơn giản được chuyển thành bảng dùng dấu gạch đứng theo kiểu GFM. Kiểm tra tiêu đề và các ô ban đầu trải dài qua nhiều hàng hoặc cột.
Kiểm tra văn bản và bản kết xuất
Chuyển giữa mã nguồn Markdown và bản xem trước. Mã nguồn là kết quả cần dùng; bản xem trước giúp phát hiện cấu trúc phân cấp bị thiếu hoặc chỗ xuống dòng bất ngờ.
Quy trình chuyển đổi trên thiết bị
Mở tệp HTML/văn bản hoặc dán mã nguồn rồi sao chép hay tải Markdown xuống. Không cần tải dữ liệu lên để chuyển đổi.
Bắt đầu với tài liệu bạn thực sự cần
Trích đoạn bài viết HTML
Đưa nội dung bài viết vào bản nháp tài liệu hoặc kho mã.
<h2>Danh sách kiểm tra rà soát</h2> <p>Kiểm tra <strong>mã nguồn</strong> trước khi xuất bản.</p> <ul><li>Xác minh các nhận định</li><li>Kiểm tra liên kết</li></ul>
- Cấp tiêu đề được giữ lại
- Phần nhấn mạnh vẫn dễ đọc
- Các mục danh sách vẫn tách biệt
Bảng HTML nhỏ
Chuyển các ô thông thường thành bảng Markdown có thể chỉnh sửa.
<table> <thead><tr><th>Định dạng</th><th>Mục đích</th></tr></thead> <tbody><tr><td>HTML</td><td>Nội dung web</td></tr><tr><td>Markdown</td><td>Mã nguồn có thể chỉnh sửa</td></tr></tbody> </table>
- Có hàng tiêu đề rõ ràng
- Không giả định có ô gộp
- Nội dung ô đầy đủ
Quy trình thực tế
Dùng đúng mã nguồn HTML
Dán mã đánh dấu hoặc mở tệp .html/.htm. Đừng dán URL và mong trang web được tải về; việc sao chép trang đã kết xuất cũng không phải lúc nào chứa mã nguồn.
Xem lại những gì đã được đơn giản hóa
Kiểm tra cấp tiêu đề, danh sách lồng nhau và hàng tiêu đề của bảng. Các vùng bố cục và kiểu CSS không thuộc kết quả Markdown.
Hoàn thiện bản nháp
Sao chép Markdown hoặc tải MD xuống. Tiếp tục trong trình soạn thảo Markdown nếu bạn cần sắp xếp lại bảng, chỉnh khối mã hoặc thêm phần giải thích.
Kiểm tra kết quả trước khi chia sẻ
| Nội dung | Việc cần làm | Kết quả mong đợi |
|---|---|---|
| Ô gộp | Kiểm tra thủ công nội dung rowspan và colspan. | Bảng Markdown cơ bản không thể thể hiện mọi bố cục bảng HTML. |
| Hình ảnh | Giữ URL ảnh đầy đủ, hợp lệ hoặc nhúng ảnh trên thiết bị sau. | Đường dẫn tương đối mất ngữ cảnh của trang web gốc và cần được điều chỉnh. |
| Mã và ngắt dòng | Kiểm tra khối mã được tạo và ranh giới giữa các đoạn. | Bố cục dựa trên khoảng trắng có thể cần sửa thủ công. |
| Tập lệnh và biểu mẫu nhúng | Xác nhận kết quả chỉ có phần văn bản tài liệu cần thiết. | Các tính năng tương tác của trang web được chủ động loại bỏ. |
Câu hỏi về quy trình này
Làm cách nào để chuyển HTML sang Markdown?
Dán mã nguồn HTML hoặc mở tệp .html đã lưu. Kiểm tra bản xem trước, chuyển sang Markdown để xem cú pháp được tạo, rồi sao chép hoặc tải tệp .md xuống để chỉnh sửa tiếp.
Có thể chuyển bảng HTML sang Markdown không?
Có, với cấu trúc bảng thông thường. Bảng GFM dùng dấu gạch đứng không thể thể hiện đầy đủ ô gộp, bố cục lồng nhau hoặc mọi kiểu định dạng ở cấp ô; hãy kiểm tra các trường hợp đó thủ công.
Tôi có thể nhập URL trang web không?
Trang này không tải nội dung trang web. Hãy sao chép mã nguồn HTML liên quan hoặc lưu tệp HTML rồi mở. Nội dung động có thể cần quy trình trích xuất riêng.
Phông chữ, màu sắc và bố cục có được giữ lại không?
Markdown thể hiện cấu trúc tài liệu chứ không phải mọi kiểu trình bày tùy ý của trang. Tập lệnh, biểu mẫu, CSS tùy chỉnh và thành phần tương tác sẽ bị loại bỏ.
Vì sao ảnh không còn hiển thị?
Ảnh có thể dùng đường dẫn tương đối hoặc phụ thuộc trang web gốc. Hãy thay bằng URL đầy đủ, hợp lệ hoặc thêm ảnh trên thiết bị vào trình soạn thảo Markdown.
HTML của tôi có được tải lên không?
Việc chuyển HTML sang Markdown, xem trước và tải MD diễn ra trên thiết bị trong trình duyệt. Nếu bật tải ảnh bên ngoài, trình duyệt sẽ kết nối đến máy chủ ảnh.
Cách công cụ xử lý tài liệu của bạn
- Mã nguồn HTML được làm sạch trước khi chuyển đổi trên thiết bị.
- Kết quả là nội dung tài liệu, không phải bản sao có thể chạy của trang web.
- Trình chỉnh sửa đích có thể xử lý các phần mở rộng Markdown khác nhau; hãy thử một ví dụ nhỏ trước.
Tài liệu tham khảo về định dạngDự án TurndownBảng GitHub Flavored Markdown
Báo cáo lỗi có thể tái hiệnCho biết trình duyệt, cài đặt đã chọn và một ví dụ nhỏ không chứa thông tin mật. Không gửi tài liệu riêng tư qua email.
