Word đến Markdown Hướng dẫn định dạng: Bảo tồn mọi phong cách.

Định dạng là nơi hầu hết Word-to-Markdown chuyển đổi đi sai. Văn bản đậm xuất hiện như văn bản đơn giản. Các bàn sụp đổ. Các tiêu đề trở thành các đoạn văn không có kiểu. Hướng dẫn này giải thích chính xác những gì xảy ra trong Word sang Markdown chuyển đổi và làm thế nào để kiểm soát đầu ra.

Hiểu được đường ống chuyển đổi

Khi bạn chuyển đổi tài liệu Word thành Markdown, hai điều xảy ra:

DOCX → HTML mammoth.js phân tích Word XML và lập bản đồ mỗi yếu tố để HTML
HTML → Markdown Turndown chuyển đổi HTML thành Markdown

Bước thứ hai là không mất mát nếu HTML là sạch. Bước đầu tiên là nơi định dạng phức tạp vấn đề Words phong cách cần phải lập bản đồ để biết HTML tương đương.

Sử dụng WordToMDs chuyển đổi để xem chính xác làm thế nào tài liệu của bạn chuyển đổi trong thời gian thực.

Phong cách tiêu đề

Quyết định định dạng quan trọng nhất trong Word là sử dụng kiểu tiêu đề được tích hợp.

Word Phong cách	Markdown Sản lượng
Nhóm 1	`# Heading`
Nhóm 2	`## Heading`
Nhóm 3	`### Heading`
Thông thường (văn bản đậm)	`text` (Không có tiêu đề)

Sai lầm phổ biến: Định dạng văn bản bằng tay là lớn và đậm thay vì áp dụng kiểu tiêu đề. Điều này trông giống như một tiêu đề trong Word nhưng chuyển đổi thành văn bản đậm trong Markdown, không ##.

Đối với các tiêu đề tham chiếu đầy đủ, xem Markdown Hướng dẫn tiêu đề.

Đăng trọng văn bản

Word Định dạng	Markdown Sản lượng
Dũng cảm	`Bold`
Đọc theo đường nét	`Italic`
Chữ đậm (Italic)	`*Bold Italic*`
~~Đánh qua~~	`~~Strikethrough~~`
Đặt dưới	(không có Markdown tương đương bỏ qua)
Đánh dấu	(không có tiêu chuẩn Markdown bị bỏ qua)

Đặt dưới và làm nổi bật không có Markdown tương đương trong ngữ pháp tiêu chuẩn. Sau khi chuyển đổi, sử dụng HTML <u> thẻ hoặc lớp CSS tùy chỉnh nếu nền tảng xuất bản của bạn hỗ trợ chúng.

Danh sách

Words tự động định dạng danh sách chuyển đổi sạch:

- Bullet item one
- Bullet item two
  - Nested bullet (indent 2 spaces)

1. First item
2. Second item
   1. Nested numbered item

Điều gì phá vỡ danh sách: Các dấu chấm hoặc số được gõ bằng tay không phải là các mục danh sách Word thực tế. Chúng trông giống như danh sách nhưng Word coi chúng như là các đoạn văn bản đơn giản. Giải pháp: chọn chúng trong Word và áp dụng phong cách List Bullet hoặc List Number.

Bảng

Bảng tiêu chuẩn chuyển đổi thành GitHub Có hương vị Markdown table syntax:

| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |

Cái gì phá vỡ bàn:

Các ô sáp nhập các ô bao gồm nhiều cột hoặc hàng sẽ bị sáp nhập
Nội dung tế bào nhiều dòng các đoạn đường bên trong các tế bào được loại bỏ
Các bảng bảng bên trong được phẳng thành văn bản đơn giản

Để biết chi tiết đầy đủ, xem Markdown Bảng: Hướng dẫn đầy đủ.

Mã và văn bản định dạng trước

Văn bản định dạng bằng phông chữ một không gian (Courier New, Consolas) trong bản đồ Word đến mã nội tuyến:

Use `console.log()` to debug.

Đối với các khối mã được bao vây với điểm nhấn cú pháp, áp dụng Words Code kiểu đoạn nếu mẫu của bạn có một, hoặc thêm hàng rào ba backtick thủ công sau khi chuyển đổi. Xem thêm Markdown Hướng dẫn khối mã cho tổng hợp đầy đủ.

Hình liên kết

Word liên kết chuyển đổi hoàn hảo:

Visit [WordToMD](https://wordtomd.org) for instant conversion.

Các văn bản liên kết và URL đều được bảo quản. Bookmarks (các liên kết nội bộ trong cùng một tài liệu) có thể không chuyển đổi nếu mục tiêu không tồn tại trong Markdown.

Hình ảnh

Hình ảnh là nơi chuyển đổi từ Word-to-Markdown luôn thiếu. mammoth.js có thể chiết xuất hình ảnh nhúng như base64 dữ liệu URI, nhưng hành vi mặc định là để lưu ý sự hiện diện của họ trong Conversion Notes. Sau khi chuyển đổi:

Xuất hình ảnh từ Word: File → Save As → Web Page (HTML)
Ghi chú chúng trong Markdown: ![Alt text](path/to/image.png)

Các ký tự và biểu tượng đặc biệt

Word thường tự động chèn các ký tự Unicode đặc biệt:

Các báo giá thông minh ("...") → được lưu giữ như các ký tự Unicode
Em dash (—) → được bảo quản
Không gian không phá → chuyển thành không gian thông thường

Nếu bạn cần đầu ra chỉ ASCII, hãy tìm và thay thế trong trình soạn thảo văn bản của bạn sau khi chuyển đổi.

Word Custom Styles

Nếu tài liệu Word của bạn sử dụng phong cách đoạn văn tùy chỉnh (như Callout hoặc Warning), mammoth.js ghi lại chúng như ghi chú chuyển đổi. Bạn sẽ thấy tin nhắn như Không nhận ra kiểu đoạn văn: Callout. WordToMD sẽ lọc các tin nhắn thông tin này theo mặc định.

Để xử lý phong cách tùy chỉnh, bạn sẽ cần thiết lập Pandoc địa phương với bộ lọc tùy chỉnh xem Pandoc Word đến Markdown cho cách tiếp cận đó.

Định dạng danh sách kiểm tra trước khi bạn chuyển đổi

Áp dụng danh sách kiểm tra này cho tài liệu Word của bạn trước khi chuyển đổi:

Tất cả các tiêu đề sử dụng Words xây dựng trong tiêu đề 1/2/3 phong cách (không phải định dạng thủ công)
Danh sách được tạo bằng các công cụ danh sách Words (không nhập dấu gạch/số)
Bảng là lưới đơn giản (không có ô sáp nhập)
Mã sử dụng phông chữ một không gian
Các liên kết siêu việt là các liên kết siêu việt thực sự (không chỉ là văn bản được đánh dấu màu xanh dương)

FAQ

Tại sao các tiêu đề của tôi được chuyển đổi thành văn bản đậm? Bạn đã áp dụng định dạng chữ đậm + kích cỡ phông chữ thay vì phong cách tiêu đề. Trong Word, nhấp vào đoạn và nhìn vào bảng phong cách nó nên nói Tiêu đề 1 không phải Thông thường.

Danh sách số của tôi bắt đầu lại với 1 ở chỗ không đúng làm thế nào để sửa nó? Thiết lập tiếp tục danh sách trong Word: nhấp chuột phải vào danh sách → Tiếp tục đánh số. Hoặc chỉnh sửa Markdown trực tiếp sau khi chuyển đổi.

Định vị bảng trông sai trong Markdown. Chuyện gì đã xảy ra? GFM sử dụng bảng |---| đối với các bộ phân lập liên kết. WordToMD tự động tạo ra chúng. Nếu hiển thị có vẻ sai, hãy kiểm tra rằng không có ô nào có ký tự pipe (|) trong nội dung của chúng thoát khỏi chúng như \|.

Kết luận

Làm sạch Word đến Markdown định dạng chủ yếu là về việc sử dụng Word một cách chính xác. Ứng dụng phong cách tiêu đề tích hợp, sử dụng Words danh sách và bảng công cụ, và bạn sẽ nhận được gần như hoàn hảo đầu ra từ WordToMD chuyển đổi. For edge cases — custom styles, complex tables, images — the tips above will get you the rest of the way there.