Chuyển DOCX sang Markdown
Muốn đưa tài liệu từ Word vào kho Git, trước hết bạn cần chuyển từng file .docx sang Markdown. Công cụ này xuất văn bản theo kiểu CommonMark với tiêu đề #, bảng dạng ký tự | và liên kết ảnh, sẵn sàng để commit.
Chuyển đổi tài liệu
hoặc thả tệp PDF, DOC, DOCX … vào đây ·
Tối đa 95 MB mỗi tệp· Tối đa 20 tệp· Xóa sau 30 phút
Tệp được xử lý trên máy chủ của chúng tôi và bị xóa sau 30 phút.
150 DPI biến một trang A4 thành khoảng 1240 × 1754 px. Dùng 300 để in.
Chuyển toàn bộ tệp hoặc chỉ một số trang hay trang chiếu (với đầu vào PDF và bản trình chiếu).
Các trang hoặc trang chiếu cần chuyển, ví dụ 1-3, 5, 8-10.
UTF-8 dùng được cho mọi ngôn ngữ. Chọn UTF-8 có BOM nếu Excel hoặc Notepad trên Windows hiển thị ký tự lỗi; chỉ dùng các bảng mã cũ cho phần mềm cũ.
LF cho macOS, Linux và trình soạn thảo mã; CRLF cho các chương trình Windows cũ như Notepad bản cổ điển.
Dấu phẩy là chuẩn. Dùng dấu chấm phẩy cho Excel ở các nước viết số thập phân bằng dấu phẩy (Đức, Pháp, Brazil).
Với đầu vào Excel có nhiều trang tính: chuyển tất cả (mỗi trang tính một phần hoặc một tệp) hoặc chỉ trang đầu tiên.
Cách sử dụng công cụ này
- 1
Tải lên các file Word
Thêm tối đa 20 file .docx hoặc .doc, mỗi file tối đa 95 MB. Hãy chấp nhận hoặc từ chối các thay đổi đang theo dõi trong Word trước, vì Markdown không có cách nào hiển thị chúng.
- 2
Kiểm tra tùy chọn văn bản
Định dạng văn bản để ở Đơn giản, Mã hóa ký tự ở UTF-8 và Ký tự xuống dòng ở LF, tổ hợp mà Git và các trình tạo trang tĩnh mong đợi. Giữ bật Bao gồm hình ảnh để lưu ảnh vào một thư mục.
- 3
Chuyển đổi và giải nén
Nhấn Chuyển sang MD. Mỗi tài liệu được trả về dưới dạng một file ZIP gồm file .md và các ảnh đi kèm; hãy giải nén vào thư mục tài liệu rồi commit.
Làm thế nào để chuyển tài liệu Word sang Markdown?
Tải file .docx lên và nhấn Chuyển sang MD. Bạn nhận được một file .md có tiêu đề #, danh sách, liên kết và bảng, cùng các ảnh trong thư mục bên cạnh, tất cả nằm trong một file ZIP.
Chuyển DOCX sang Markdown cho docs-as-code
Các nhóm áp dụng docs-as-code vì một lý do: tài liệu khi đó nằm cạnh mã nguồn, đi qua cùng các pull request và phát hành cùng một bản release. File .docx phá vỡ điều đó, vì nó là một file ZIP chứa các phần XML mà Git lưu như một tệp nhị phân khó đọc. Thay đổi một từ cũng chỉ hiện ra là một file đã đổi mà không có bản so sánh đọc được, và hai người cùng chỉnh sửa không thể hợp nhất công việc của nhau.
Markdown là văn bản thuần, nên mỗi chỉnh sửa là một thay đổi dòng nhìn thấy được. Nó cũng trở nên dễ đoán hơn nhiều vào năm 2014, khi John MacFarlane và những người khác công bố CommonMark, một đặc tả chính xác cho cú pháp mà Gruber đã mô tả khá lỏng lẻo mười năm trước đó. Năm 2017, GitHub xây dựng đặc tả GitHub Flavored Markdown của riêng mình dựa trên CommonMark, bổ sung bảng dấu gạch đứng, danh sách công việc và chữ gạch ngang mà hầu hết README ngày nay sử dụng.
Nếu nội dung của bạn đi theo chiều ngược lại, tức Markdown gửi cho người duyệt làm việc trong Word, hãy dùng Chuyển Markdown sang DOCX. Với trang web thay vì kho mã, Chuyển DOCX sang HTML giữ lại nhiều kiểu dáng hơn.
Kết quả Markdown trông như thế nào
## Danh sách kiểm tra trước khi phát hành Trước khi gắn tag phát hành, hãy xác nhận các mục sau: - Kiểm thử đều đạt trên **main** - Changelog liệt kê mọi PR đã merge | Bước | Phụ trách | | --- | --- | | Build | CI | | Xuất bản | Người bảo trì | 
Markdown sau khi chuyển sẽ hiển thị ở đâu
| Tổ chức | Yêu cầu | Nguồn |
|---|---|---|
| GitHub | Hiển thị README.md và mọi file .md trong kho mã bằng GitHub Flavored Markdown | github.com |
| Hugo | Tạo trang từ các file nội dung .md bằng trình phân tích tuân thủ CommonMark | gohugo.io |
| Jekyll | Biến các file .md có front matter thành trang; là công cụ đứng sau GitHub Pages | jekyllrb.com |
| Docusaurus | Đọc các file .md và .mdx trong thư mục docs thành các trang tài liệu | docusaurus.io |
DOCX
Tài liệu Microsoft Word
DOCX là định dạng tài liệu mặc định của Microsoft Word từ Office 2007, dựa trên tiêu chuẩn Office Open XML (ECMA-376, ISO/IEC 29500). Đây là một gói ZIP gồm các tệp XML chứa văn bản, kiểu định dạng, hình ảnh, bảng, nhận xét và theo dõi thay đổi. DOCX là định dạng phổ biến nhất cho tài liệu có thể chỉnh sửa trong văn phòng, trường học và hồ sơ xin việc. Bố cục có thể xê dịch đôi chút giữa Word, Google Docs, LibreOffice và Pages, nhất là với định dạng phức tạp. Hầu hết trình xử lý văn bản đều mở được tệp DOCX.
- Nén
- –
- Độ trong suốt
- –
- Ảnh động
- –
- Ra mắt
- 2007 · Microsoft
MD
Văn bản Markdown
Markdown là cú pháp đánh dấu gọn nhẹ do John Gruber tạo ra năm 2004. Cú pháp dùng các ký hiệu văn bản thuần, như # cho tiêu đề, * cho nhấn mạnh và - cho danh sách, vẫn dễ đọc ở dạng văn bản thô và chuyển sang HTML gọn gàng. Markdown là tiêu chuẩn cho tệp README, tài liệu kỹ thuật, wiki, ứng dụng ghi chú và nhiều trình tạo trang tĩnh. Có nhiều phương ngữ, như CommonMark và GitHub Flavored Markdown, khác nhau ở các chi tiết như bảng. Mọi trình soạn thảo văn bản đều mở được tệp .md.
- Nén
- –
- Độ trong suốt
- –
- Ảnh động
- –
- Ra mắt
- 2004 · John Gruber
DOCX được chuyển sang Markdown khi tài liệu đi vào quy trình làm việc với mã nguồn: README, trang tài liệu hoặc cơ sở tri thức lưu trong Git, nơi văn bản thuần có thể so sánh khác biệt, xem xét trong pull request và được nhiều công cụ hiển thị.
Các tính năng Word không có tương đương trong Markdown
Lưu ý những điểm này trước khi chuyển đổi
- Phông chữ, màu sắc và bố cục trang bị bỏ đi; Markdown mô tả cấu trúc, còn giao diện do theme của trang quyết định
- Các thay đổi được theo dõi và bình luận không được giữ lại, nên hãy xử lý chúng trong Word trước
- Đầu trang, chân trang và số trang không có chỗ trong file .md
- Hộp văn bản và ảnh có chữ bao quanh trở thành đoạn văn thường và liên kết ảnh
- Tiêu đề bạn tự định dạng bằng tay, in đậm cỡ 16 pt thay vì Heading 2, sẽ thành chữ in đậm, nên hãy áp dụng kiểu tiêu đề thật trước
- Gạch chân không có cú pháp Markdown và sẽ bị loại bỏ hoặc giữ lại dưới dạng HTML
Câu hỏi về chuyển DOCX sang Markdown
Kết quả chuyển DOCX sang MD theo chuẩn Markdown nào?
Tiêu đề, định dạng nhấn mạnh, danh sách, liên kết và mã tuân theo CommonMark, còn bảng dùng cú pháp dấu gạch đứng của GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll và Docusaurus đều hiển thị được tổ hợp này.
Ô bảng đã gộp sẽ được xử lý thế nào?
Bảng dạng dấu gạch đứng trong Markdown không có ô gộp, nên mỗi vùng đã gộp được tách lại thành từng ô riêng, với văn bản nằm ở ô đầu tiên. Hãy dựng lại các bảng phức tạp bằng HTML bên trong file .md, hoặc đơn giản hóa chúng trong Word trước khi chuyển.
Ảnh trong tài liệu Word của tôi được lưu ở đâu?
Khi bật Bao gồm hình ảnh, mỗi ảnh được lưu thành một file riêng trong ZIP, và Markdown liên kết tới ảnh bằng đường dẫn tương đối như images/figure-1.png. Hãy giữ thư mục ảnh cạnh file .md khi bạn di chuyển nó.
Chú thích cuối trang của Word có được giữ lại trong Markdown không?
CommonMark không có cú pháp chú thích cuối trang, nhưng GitHub đã bổ sung chú thích [^1] vào năm 2021 và hầu hết các trình tạo trang đều hỗ trợ. Nếu trình hiển thị của bạn không hỗ trợ, nội dung chú thích sẽ hiện thành các đoạn văn thường ở cuối.
Có thể chuyển Google Docs sang Markdown theo cách này không?
Có. Trong Google Tài liệu, hãy chọn Tệp > Tải xuống > Microsoft Word (.docx), rồi tải file đó lên đây. Google Tài liệu cũng có sẵn tùy chọn tải xuống Markdown, dùng tốt cho các tài liệu đơn giản.
