Công cụ làm gì
Công cụ chuyển HTML sang Markdown biến mã HTML thành Markdown gọn gàng, dễ đọc. Bạn có thể dùng nó để chuyển bài blog từ CMS sang trình tạo trang tĩnh, viết tệp README từ các trang web có sẵn, lưu tài liệu thành ghi chú hoặc chuẩn bị nội dung cho wiki, issue trên GitHub hay ứng dụng chat hỗ trợ Markdown.
Kết quả tuân theo các quy ước Markdown phổ biến: tiêu đề #, mục danh sách -, khối mã có rào giữ nguyên ngôn ngữ, cùng bảng và gạch ngang của GitHub Flavored Markdown. Văn bản được thoát ký tự khi cần để không có gì vô tình trở thành định dạng.
Cách sử dụng
- Dán HTML vào ô nhập, tải lên tệp
.htmlhoặc bấm Ví dụ. - Điều chỉnh phong cách nếu dự án có quy ước riêng: ký hiệu danh sách, khối mã có rào hoặc thụt lề, ký hiệu nghiêng và đậm, liên kết nội dòng hoặc kiểu tham chiếu.
- Sao chép Markdown hoặc tải xuống dưới dạng tệp
.md.
Ví dụ
Đoạn HTML này:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul><li>Windows</li><li>macOS</li></ul>
trở thành Markdown sau:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
Mẹo
- Sao chép từ trình duyệt? Dùng mã nguồn trang hoặc công cụ dành cho nhà phát triển để chỉ lấy HTML của phần tử article, tránh đưa menu và chân trang vào kết quả.
- Liên kết kiểu tham chiếu đưa các URL dài ra khỏi văn bản, giúp Markdown dễ đọc và chỉnh sửa hơn. Các URL được liệt kê ở cuối.
- Ảnh
data:nhúng bị loại bỏ theo mặc định vì chúng có thể dài hàng trăm kilobyte. Bật tùy chọn để giữ lại. - Để chuyển theo chiều ngược lại, hãy dùng công cụ chuyển Markdown sang HTML hoặc xem kết quả trong trình xem trước Markdown.
Câu hỏi thường gặp
› Những phần tử HTML nào được chuyển đổi?
Tiêu đề, đoạn văn, in đậm, in nghiêng, gạch ngang, liên kết, hình ảnh, danh sách có số và không số (kể cả lồng nhau), trích dẫn, mã nội dòng, khối mã kèm ngôn ngữ, đường kẻ ngang, ngắt dòng và bảng. Bảng được chuyển thành bảng GitHub Flavored Markdown.
› Script, style và phần head của trang thì sao?
Chúng bị loại bỏ. Script, style, noscript, template, svg, iframe và toàn bộ phần head không tạo ra Markdown, nên bạn có thể dán mã nguồn của cả trang web và chỉ nhận phần nội dung đọc được.
› Còn HTML mà Markdown không biểu diễn được?
Thẻ không xác định bị gỡ bỏ, văn bản bên trong được giữ lại. Các thuộc tính như class, style nội dòng và id bị bỏ qua vì Markdown không có cú pháp cho chúng. Khối mã giữ ngôn ngữ khi phần tử code có class như language-js.
› Vì sao một số ký tự có dấu gạch chéo ngược phía trước?
Văn bản vốn sẽ biến thành định dạng Markdown, chẳng hạn một dòng bắt đầu bằng 1. hoặc các từ nằm giữa dấu sao, được thoát ký tự để Markdown hiển thị giống hệt văn bản HTML gốc.
› HTML có bị tải lên không?
Không. Việc chuyển đổi chạy trong trình duyệt bằng một trình phân tích HTML viết bằng JavaScript và không có gì được gửi lên máy chủ.