การจัดรูปเป็นจุดที่การแปลงส่วนใหญ่ของ Word-to-Markdown ผิดพลาด ข้อความหนาจะแสดงเป็นข้อความธรรมดา โต๊ะล่มลง หัวข้อเปลี่ยนไปเป็นข้อที่ไม่มีสไตล์ คู่มือนี้อธิบายอย่างละเอียด ว่าเกิดอะไรขึ้นระหว่าง Word เป็น Markdown การแปลงและวิธีการควบคุมผลิต
การเข้าใจการแปลงท่อ
เมื่อคุณแปลงเอกสาร Word เป็น Markdown มีสองสิ่งเกิดขึ้น:
- DOCX → HTML mammoth.js แพร์ส XML Word และแผนที่แต่ละองค์ประกอบที่ HTML
- HTML → Markdown การปรับเปลี่ยนการใช้ HTML เป็น Markdown
ขั้นตอนที่สองไม่มีการสูญเสีย หาก HTML สะอาด ขั้นตอนแรกคือการจัดรูปความซับซ้อนของเรื่องต่างๆ สไตล์ของ Words ต้องการแผนที่กับเทียบเท่า HTML ที่รู้จัก.
การใช้ WordToMDs แปลง เพื่อดูว่าเอกสารของคุณแปลงเป็นอย่างไรในเวลาจริง
สไตล์หัวข้อ
การตัดสินใจการจัดรูปที่สําคัญที่สุดใน Word คือการใช้สไตล์หัวข้อในตัว
| Word สไตล์ | Markdown ผลิต |
|---|---|
| หมวด 1 | # Heading |
| หมวด 2 | ## Heading |
| หมวด 3 | ### Heading |
| ปกติ (ข้อความแข็งแรง) | **text** (ไม่มีหัวข้อ) |
ความผิดปกติทั่วไป: การจัดรูปแบบข้อความด้วยมือเป็นขนาดใหญ่และ bold แทนที่จะใช้สไตล์ Heading นี่ดูเหมือนหัวข้อใน Word แต่แปลงเป็นข้อความ bold ใน Markdown, ไม่ใช่ ##.
สําหรับคําอ้างอิงหัวข้อทั้งหมด ดู Markdown คู่มือหัวข้อ.
การ เน้น ข้อความ
| Word การจัดรูป | Markdown ผลิต |
|---|---|
| กล้าหาญ | **Bold** |
| อักษรอักษร | *Italic* |
| อักษรไทย | ***Bold Italic*** |
~~Strikethrough~~ | |
| หมายเลข | (ไม่มี Markdown เท่ากับ หายไป) |
| เฉพาะ | (ไม่มีมาตรฐาน Markdown ออกไป) |
การตักทายและการเร่งขันไม่มีเทียบเท่า Markdown ในสัญลักษณ์มาตรฐาน. หลังจากการแปลง, ใช้ HTML <u> แท็กหรือคลาส CSS ที่ได้รับการกําหนดเอง หากแพลตฟอร์มการพิมพ์ของคุณรองรับมัน
รายการ
Words การจัดรูปแบบรายการอัตโนมัติ เปลี่ยนแปลงอย่างสะอาด:
- Bullet item one
- Bullet item two
- Nested bullet (indent 2 spaces)
1. First item
2. Second item
1. Nested numbered item
สิ่งที่ทําลายรายการ หมายเลขที่เขียนด้วยมือที่ไม่ใช่ตัวเลขในรายการ Word เหล่านี้ดูเหมือนรายการอย่างเห็น แต่ Word พิจารณาพวกเขาเป็นข้อความเรียบง่าย การแก้ไข: เลือกมันใน Word และใช้สไตล์ List Bullet หรือ List Number
ตาราง
ตารางมาตรฐานแปลงเป็น GitHub รสชาติ Markdown การประกอบตาราง:
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |
อะไรจะทําลายตาราง:
- เซลล์ที่รวมกัน เซลล์ที่ครอบคลุมหลายคอลัมน์หรือแถว จะถูกรวมกัน
- เนื้อหาเซลล์หลายเส้น เส้นแตกภายในเซลล์ถูกตัด
- โต๊ะที่วางตัว โต๊ะภายในถูกแผ่นเป็นข้อความเรียบ
สําหรับการแบ่งแยกอย่างสมบูรณ์ ดู Markdown ตาราง: คู่มือที่ครบวงจร.
รหัสและข้อความที่จัดรูปแบบก่อนหน้า
ข้อความที่จัดรูปแบบด้วยตัวอักษรแบบเดียว (Courier New, Consolas) ในแผนที่ Word เป็นรหัสในเส้น:
Use `console.log()` to debug.
สําหรับบล็อกโค้ดที่ติดกั้นที่มีการเร่งสัญลักษณ์การเขียน, ใช้ Words Code style paragraph ถ้าตารางของคุณมี หรือเพิ่มรั้วหลังสามตัวด้วยมือหลังจากการแปลง ดู Markdown คอยด์บล็อค คู่มือ สําหรับการประโยคเต็ม
การเชื่อมโยง
Word ไฮเปอร์ลิงค์แปลงอย่างสมบูรณ์แบบ:
Visit [WordToMD](https://wordtomd.org) for instant conversion.
ข้อความลิงค์และ URL ทั้งสองถูกรักษาไว้ เบอร์มาร์ค (ลิงก์ภายในเอกสารเดียวกัน) อาจจะไม่แปลงถ้าเป้าหมายไม่มีอยู่ใน Markdown.
รูปภาพ
รูปภาพคือสถานที่การแปลง Word-to-Markdown ผิดพลาดอย่างต่อเนื่อง. mammoth.js สามารถสกัดภาพที่ติดตั้งเป็น URI ข้อมูล base64 ได้ แต่พฤติกรรมแบบถัดไปคือการสังเกตความเป็นอยู่ของพวกมันใน Conversion Notes หลังการแปลง:
- การส่งออกภาพจาก Word: File → Save As → Web Page (HTML)
- ส่งหมายไปใน Markdown:

ตัวอักษร และ สัญลักษณ์พิเศษ
Word มักจะใส่ตัวอักษรยูนิโค้ดพิเศษโดยอัตโนมัติ:
- การนําเสนอราคาที่ฉลาด (
"...") → ถูกอนุรักษ์เป็นตัวอักษร Unicode - Em dash (
—) → ปรุงรักษา - สเปซที่ไม่แตก → เปลี่ยนเป็นสเปซปกติ
- สัญลักษณ์ลิขสิทธิ์ (
©) → ปรุงรักษา
หากคุณต้องการผลิต ASCII เท่านั้น, ทําการหาและเปลี่ยนในเครื่องแก้ไขข้อความของคุณหลังจากการแปลง.
Word สไตล์ที่กําหนดเอง
หากเอกสาร Word ของคุณใช้สไตล์ข้อความที่กําหนดเอง (เช่น Callout หรือ Warning) mammoth.js จะบันทึกมันเป็นข้อความแปลง คุณจะได้เห็นข้อความเช่น ไม่รับรู้สไตล์ข้อความ: Callout. WordToMD จะกรองข้อความข้อมูลเหล่านี้โดยตั้งค่า
เพื่อจัดการสไตล์ที่กําหนดเอง, คุณต้องการการตั้งค่า Pandoc ท้องถิ่นพร้อมกับกรองที่กําหนดเอง ดู Pandoc Word ถึง Markdown สําหรับวิธีการนั้น
การประกอบตารางเช็ค ก่อนที่คุณแปลง
ใช้รายการเช็คนี้กับเอกสาร Word ก่อนแปลง:
- หัวข้อทั้งหมดใช้ Words แบบหัวข้อ 1/2/3 (ไม่ใช่การจัดรูปแบบด้วยมือ)
- รายการถูกสร้างด้วยเครื่องมือรายการ Words (ไม่ใส่เส้นสั้น / เลข)
- ตารางเป็นเครือข่ายง่าย (ไม่มีเซลล์รวม)
- โค้ดใช้ตัวอักษรแบบ mono-space
- ไฮเปอร์ลิงก์คือ ไฮเปอร์ลิงก์จริง (ไม่ใช่แค่ข้อความที่ถูกตักทายในสีน้ําเงิน)
FAQ
ทําไมหัวข้อผมต้องแปลงเป็น bold text? คุณใช้การจัดรูปแบบแบบขั้น bold + font size แทนการใช้แบบ Heading ใน Word คลิ๊กที่ข้อและดูในกระดานสไตล์ มันควรจะบอกว่า หัวข้อ 1 ไม่ใช่ ปกติ.
รายการเลขของฉันเริ่มใหม่ที่ 1 ในที่ผิด ฉันจะแก้ไขมันอย่างไร? วางรายการต่อเนื่องใน Word: คลิกขวาในรายการ → ต่อไปการนับ หรือแก้ไข Markdown โดยตรงหลังจากการแปลง
การจัดโต๊ะดูผิดใน Markdown เกิดอะไรขึ้น?
การใช้ตาราง GFM |---| สําหรับเครื่องแยกการปรับ WordToMD สร้างสิ่งเหล่านี้โดยอัตโนมัติ หากการแสดงออกดูผิดไป ตรวจสอบว่าไม่มีเซลล์ที่มีตัวอักษรไพป์ (|) ในเนื้อหาของพวกเขา \|.
การสรุป
ทําความสะอาด Word เป็น Markdown การจัดรูป ส่วนใหญ่เกี่ยวกับการใช้ Word อย่างถูกต้อง ใช้สไตล์หัวข้อในระบบ ใช้เครื่องมือลิสต์และตารางของ Word และคุณจะได้ผลิตที่เกือบสมบูรณ์แบบจาก WordToMD แปลง. For edge cases — custom styles, complex tables, images — the tips above will get you the rest of the way there.