WordToMD là gì?

Nhiệm vụ của chúng tôi

WordToMD tồn tại để giải quyết một vấn đề cụ thể, phổ biến: đưa nội dung ra khỏi tài liệu Word và vào Markdown mà không cần phải định dạng thủ công. Cho dù bạn là một nhà phát triển viết tài liệu, một nhà văn duy trì một blog, hoặc một tổ chức di chuyển một cơ sở kiến thức bước chuyển đổi Word-to-Markdown không nên đau đớn.

Cách hoạt động

WordToMD được cung cấp bởi hai thư viện nguồn mở tuyệt vời:

• mammoth.js Đọc các tệp .docx trong trình duyệt thông qua FileReader API và chuyển đổi chúng thành HTML sạch, lập bản đồ phong cách Word (Chương mục 1, Chương mục 2, v.v.) đối với tương đương HTML của chúng.
• turndown Chuyển đổi đầu ra HTML từ mammoth thành Markdown tiêu chuẩn, với các quy tắc tùy chỉnh cho bảng (GitHub Flavored Markdown), khối mã, và các yếu tố khác.

Toàn bộ đường ống chạy trong tab trình duyệt của bạn. Tệp được đọc bằng cách sử dụng FileReader API, chưa bao giờ được truyền qua mạng.

Tiếp cận riêng tư

Nhiều công cụ chuyển đổi tài liệu yêu cầu bạn tải tệp lên máy chủ. Điều đó có nghĩa là nội dung của bạn báo cáo tiềm tàng bí mật, tài liệu khách hàng, nội bộ cơ sở kiến thức đi qua cơ sở hạ tầng của người khác.

WordToMD là kiến trúc khác nhau: logic chuyển đổi chạy trong JavaScript trong tab trình duyệt của bạn. Các byte tập tin không bao giờ rời khỏi thiết bị của bạn. Bạn có thể xác minh điều này bằng cách mở tab Mạng (F12) của trình duyệt của bạn trước khi chuyển đổi bạn sẽ thấy không có yêu cầu tải lên tệp.

Những gì được bảo tồn

Các yếu tố Word sau đây được chuyển đổi một cách đáng tin cậy:

• Các tiêu đề (H1H6) → Các tiêu đề theo kiểu ATX Markdown
• Bold (** văn bản**) và chữ lật lật (_text_) định dạng
• Danh sách sắp xếp và không sắp xếp, bao gồm cả danh sách lồng
• Bảng → GitHub hương vị Markdown table syntax
• Các liên kết với văn bản neo
• Một không gian / văn bản theo kiểu mã
• Tất cả các ký tự Unicode (Trung Quốc, Nhật Bản, Ả Rập, emoji, v.v.)

Giới hạn được biết đến

Một số tính năng Word không có tương đương Markdown:

• Các ô bảng kết hợp được đơn giản hóa thành các cột liền kề
• Hình ảnh nhúng được xuất sang thư mục hình ảnh khi bạn chọn Markdown + hình ảnh ZIP tải xuống
• Hộp văn bản và SmartArt không được hỗ trợ
• Phương thức đoạn văn tùy chỉnh so sánh với chuẩn tương đương gần nhất
• Các thay đổi theo dõi / bình luận được loại bỏ (chỉ nội dung cuối cùng được chuyển đổi)

Khi một con bò khổng lồ phát hiện các nguyên tố nó không thể chuyển đổi hoàn toàn, bảng "Conversion Notes" trong dạng xem kết quả sẽ liệt kê chúng để bạn có thể xem lại bằng tay.