Word إلى Markdown دليل التنسيق: الحفاظ على كل نمط

التنسيق هو حيث معظم Word-to-Markdown التحويلات تذهب خطأ. النص الجليد يظهر كنص عادي. الطاولات تنهار العناوين تتحول إلى فقرات غير مصممة. هذا الدليل يوضح بالضبط ما يحدث خلال Word إلى Markdown كيفية التحكم في الناتج.

فهم خط أنابيب التحويل

عند تحويل مستند Word إلى Markdown، يحدث شيئان:

1. DOCX → HTML mammoth.js تحليل Word XML وترسيم كل عنصر إلى HTML
2. HTML → Markdown التحول يحول HTML إلى Markdown

الخطوة الثانية خالية من الخسائر إذا كان HTML نظيفاً. الخطوة الأولى هي حيث تشكيل الأمور المعقدة Words أنماط تحتاج إلى خريطة إلى المعروفة HTML مكافئ.

الاستخدام WordToMDs محول لمعرفة بالضبط كيفية تحويل المستند الخاص بك في الوقت الحقيقي.

أنماط العنوان

أهم قرار التنسيق في Word هو استخدام أنماط العناوين المدمجة.

الخطأ الشائع: صياغة النص يدوياً كالكبير والجليد بدلاً من تطبيق نمط العنوان. هذا يبدو وكأنه عنوان في Word ولكنه يحول إلى النص الساخن في Markdown، وليس ##.

الرجوع الكامل للرسوم، انظر Markdown دليل العناوين.

التأكيد على النص

لا يوجد ما يعادله "مارك داون" في الجملة القياسية. بعد التحويل، استخدم HTML <u> علامات أو فئات CSS المخصصة إذا كانت منصة النشر الخاصة بك تدعمها.

قوائم

Word's التنسيق التلقائي للقائمة يحول بشكل نظيف:

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

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

ما الذي يحطم القوائم: المخططات أو الأرقام المكتوبة يدويًا التي ليست عناصر قائمة Word الفعلية. هذه تبدو كقوائم بصرياً ولكن Word يعاملها كفقرات نصية بسيطة. الإصلاح: حددهم في Word وتطبيق نمط القائمة أو قائمة الرقم.

الجداول

الجداول القياسية تحويل إلى 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 النمط الفقري إذا كان النموذج الخاص بك يحتوي على واحد، أو إضافة السياج الثلاثي بعد التحويل يدوياً. انظر Markdown دليل كتلة الكود للكلمة الكاملة

الروابط الفائقة

Word الروابط التشعبيّة تتحوّل بشكل مثالي:

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

يتم الحفاظ على نص الرابط وعنوان URL. قد لا تتحوّل العلامات المفتوحة (الارتباطات الداخلية داخل نفس الوثيقة) إذا لم يكن الهدف موجودًا في Markdown.

صور

الصور هي المكان الذي يتعذر فيه تحويل Word-to-Markdown باستمرار. mammoth.js يمكن استخراج الصور المضمنة كعلامات URI للبيانات base64, ولكن السلوك الافتراضي هو ملاحظة وجودهم في ملاحظات التحويل. بعد التحويل:

1. تصدير الصور من Word: ملف → حفظ كصفحة ويب (HTML)
2. إشارة لهم في Markdown: ![Alt text](path/to/image.png)

الأحرف والرموز الخاصة

Word غالباً ما يضيف أحرف يونيكود خاصة تلقائياً:

• الأسعار الذكية ("...") → المحفوظة كحروف يونيكود
• (إيم ديش)—) → المحفوظة
• الفراغات غير المكسورة → تحولت إلى الفراغات العادية
• رمز حقوق الطبع والنشر (©) → المحفوظة

إذا كنت بحاجة إلى خروج ASCII فقط، قم بإجراء بحث واستبدال في محرر النص الخاص بك بعد التحويل.

Word أنماط مخصصة

إذا كان وثيقة Word الخاصة بك تستخدم أنماط الفقرة المخصصة (مثل Callout أو Warning) ، فإن mammoth.js سجلها كملاحظات تحويل. سترى رسائل مثل نمط الفقرة غير المعترف به: Callout. WordToMD يقوم بتصفية هذه الرسائل الإعلامية بشكل افتراضي.

للتعامل مع الأنماط المخصصة، ستحتاج إلى إعداد Pandoc محلي مع مرشح مخصص Pandoc Word إلى Markdown لهذا النهج.

صيغة قائمة التحقق قبل تحويل

قم بتطبيق قائمة التحقق هذه على مستندك Word قبل التحويل:

• جميع العناوين تستخدم Words المدمج في أنماط العناوين 1/2/3 (ليس التنسيق اليدوي)
• يتم إنشاء القوائم باستخدام أدوات القائمة Words (لا يتم كتابة المقاطع / الأرقام)
• الجداول هي شبكات بسيطة (لا توجد خلايا مدمجة)
• الكود يستخدم خط فضاء واحد
• الروابط الفائقة هي الروابط الفائقة الحقيقية (ليس فقط النص الأزرق الموضح)

FAQ

لماذا تُحول عناويني إلى نص جليد؟ لقد قمت بتطبيق تصميم يدوي للخطوط المزدوجة + حجم الخط بدلاً من نمط العنوان. في Word، انقر على الفقرة وانظر إلى لوحة الأنماط يجب أن تقول العنوان 1 ليس الطبيعي.

لقد بدأت قائمتي الرقمية من جديد في 1 في المكان الخاطئ كيف يمكنني إصلاحها؟ حدد استمرار القائمة في Word: انقر فوق القائمة بالزر الأيمن → استمر في الترقيم. أو تحرير Markdown مباشرة بعد التحويل.

يبدو أن ترتيب الطاولة خاطئ في Markdown ما الذي حدث؟ GFM استخدام الجداول |---| لفرز المواصفات. WordToMD يولد هذه تلقائيًا. إذا كان التصوير يبدو خاطئاً، تحقق من عدم وجود أحرف في الخلايا (|) في محتوياتها تبتعد عنها \|.

النتيجة

التنظيف Word إلى Markdown التنسيق هو في الغالب عن استخدام Word بشكل صحيح. تطبيق المكونة في أنماط العناوين، واستخدام Words قائمة وأدوات الجدول، وسوف تحصل على ما يقرب من الناتج المثالي من WordToMD محول. For edge cases — custom styles, complex tables, images — the tips above will get you the rest of the way there.