Cách chuyển đổi HTML sang Markdown
- Dán một đoạn HTML hoặc tải lên tệp
.htmlđược hỗ trợ. - Chuyển đổi nguồn và kiểm tra xem các phần tử ngữ nghĩa nào vẫn giữ nguyên ý nghĩa trong Markdown.
- Chuyển đổi và kiểm tra liên kết, hình ảnh, danh sách lồng nhau, bảng và khối mã.
- Sao chép Markdown hoặc tải xuống tệp
.md.
Bộ chuyển đổi giữ nguyên những gì?
| Nội dung nguồn | Hành vi đầu ra khuyến nghị | Lưu ý chuyển đổi |
|---|---|---|
| Tiêu đề | Ánh xạ <h1>–<h6> sang tiêu đề Markdown | |
| Đoạn văn và nhấn mạnh | Chuyển đổi đoạn văn, chữ in đậm và nhấn mạnh | |
| Danh sách | Chuyển đổi danh sách có thứ tự, không có thứ tự và danh sách lồng nhau | |
| Liên kết | Giữ lại văn bản và URL đã giải quyết | |
| Hình ảnh | Giữ lại nguồn và văn bản thay thế (alt) | |
| Mã nguồn | Sử dụng mã nội dòng và khối mã nguồn | |
| Bảng | Chuyển đổi bảng tương thích sang GFM | |
| Trích dẫn | Chuyển đổi các khối trích dẫn ngữ nghĩa |
Những gì có thể thay đổi trong quá trình chuyển đổi?
Tệp mã lệnh (script), kiểu dáng (style) và biểu mẫu (form)
Các phần tử thực thi và tương tác không có định dạng Markdown tương đương thông thường và có thể bị bỏ qua hoặc lược bớt thành văn bản.
Bảng phức tạp
Gộp hàng (rowspans), gộp cột (colspans), bảng lồng nhau và nội dung ô phức tạp có thể yêu cầu HTML thô hoặc làm phẳng.
Đường dẫn URL tương đối
Đoạn mã được dán có thể không chứa URL gốc của trang, vì vậy các liên kết tương đối và đường dẫn hình ảnh không phải lúc nào cũng giải quyết được.
Các khung chứa bố cục
Bố cục div, grid và flexbox không ngụ ý thứ tự đọc ngữ nghĩa.
Nội dung ẩn và nội dung mẫu (boilerplate)
Bộ chuyển đổi cần một chính sách rõ ràng đối với các phần tử ẩn, điều hướng và nội dung bị thu nhỏ về mặt trực quan.
Các ứng dụng phổ biến của chuyển đổi HTML sang Markdown
Di trú tài liệu web
Di chuyển HTML ngữ nghĩa sang hệ thống tài liệu dựa trên Markdown.
Làm sạch văn bản đa định dạng được sao chép
Chuyển đổi HTML do trình biên tập tạo ra thành một định dạng đơn giản hơn trước khi quản lý phiên bản hoặc xuất bản.
Chuẩn bị các ví dụ mã nguồn
Giữ lại các khối mã và tiêu đề mà không mang theo toàn bộ biểu định kiểu (stylesheet) của trang.
Tạo ngữ cảnh AI tập trung vào văn bản
Loại bỏ các tệp mã lệnh và kiểu dáng trong khi vẫn giữ nguyên cấu trúc thông tin cần được kiểm tra.
Ví dụ chuyển đổi HTML sang Markdown
<h2>Setup</h2>
<p>Read the <a href="/guide">guide</a>.</p>
<ul><li>Install</li><li>Test</li></ul>
## Setup
Read the [guide](/guide).
- Install
- Test
Mẹo để có đầu ra Markdown sạch hơn
- Sử dụng HTML ngữ nghĩa Các tiêu đề, danh sách và bảng chuyển đổi đáng tin cậy hơn các khung chứa bố cục chung chung.
- Cung cấp URL gốc khi cần thiết Các liên kết tương đối yêu cầu ngữ cảnh nếu kết quả cần hoạt động bên ngoài trang gốc.
- Chọn một định dạng đầu ra GFM hỗ trợ các bảng và danh sách công việc mà CommonMark cơ bản không định nghĩa.
- Kiểm tra khối mã Xác nhận ngôn ngữ lập trình được phát hiện và bất kỳ dấu nháy ngược (backticks) nào được nhúng.
- Quyết định phương án dự phòng cho HTML thô Giữ lại HTML không được hỗ trợ có thể bảo toàn thông tin nhưng làm giảm tính di động.
Câu hỏi thường gặp
Các phần tử <script> và <style> có bị loại bỏ không?
Mã lệnh và kiểu dáng không phải là nội dung Markdown hữu ích và không nên dựa vào chúng trong kết quả. Kiểm tra HTML đã dán trước khi sử dụng lại đầu ra.
Bảng HTML có được chuyển đổi thành bảng Markdown không?
Các bảng hình chữ nhật tương thích có thể trở thành bảng GFM. Các bảng có rowspan, colspan, khối lồng nhau hoặc nhiều hàng tiêu đề cần một phương án dự phòng được ghi chép lại.
Khối mã và mã nội dòng có được giữ lại không?
Chúng có thể được ánh xạ từ <pre> và <code>.
Điều gì xảy ra với liên kết và hình ảnh?
Văn bản liên kết và đích hợp lệ có thể được giữ lại. Các liên kết tương đối và đường dẫn hình ảnh vẫn phụ thuộc vào ngữ cảnh vì đoạn mã tải lên không được đảm bảo có URL gốc.
Các thẻ HTML không được hỗ trợ sẽ bị loại bỏ hay giữ lại?
Các thẻ bao bọc chỉ dành cho hiển thị có thể được đơn giản hóa trong khi văn bản dễ đọc được giữ lại. So sánh đầu ra với nguồn khi các phần tử tùy chỉnh mang ý nghĩa.
Bộ chuyển đổi xuất ra định dạng CommonMark hay GFM?
Đầu ra dự kiến là GitHub-Flavored Markdown. Bảng, văn bản bị gạch ngang và danh sách công việc phụ thuộc vào các phần mở rộng GFM.
Tôi có thể dán toàn bộ tài liệu HTML không?
Có. Bạn có thể dán một đoạn mã hoặc tải lên tệp .html hoặc .htm, sau đó xem xét Markdown được tạo ra.
Trang này có thể chuyển đổi URL của một trang web đang hoạt động không?
Không. Trang này chấp nhận HTML được dán hoặc tệp HTML được tải lên; nó không truy xuất nội dung từ một URL trang web đang hoạt động.
Chuyển đổi Markdown ngược lại thành PDF
Đã có tệp Markdown? Sử dụngbộ chuyển đổi Markdown sang PDFđể tạo một tệp PDF có thể chia sẻ.