تحويل DOCX إلى Markdown
يبدأ نقل التوثيق من Word إلى مستودع Git بتحويل كل ملف .docx إلى Markdown. تكتب هذه الأداة نصًا بأسلوب CommonMark مع عناوين # وجداول بالخطوط العمودية وروابط للصور، جاهزًا للإيداع (commit).
محوّل المستندات
أو أفلت ملفات PDF, DOC, DOCX … هنا ·
الحد الأقصى 95 MB لكل ملف· حتى 20 ملفًا· تُحذف بعد 30 دقيقة
تُعالج الملفات على خوادمنا وتُحذف بعد 30 دقيقة.
تحوّل دقة 150 DPI صفحة A4 إلى نحو 1240 × 1754 px. استخدم 300 للطباعة.
حوّل الملف كاملًا أو بعض الصفحات أو الشرائح فقط (لمدخلات PDF والعروض التقديمية).
الصفحات أو الشرائح المراد تحويلها، مثل 1-3, 5, 8-10.
يعمل UTF-8 مع جميع اللغات. اختر UTF-8 with BOM إذا عرض Excel أو Notepad على Windows حروفًا مشوّهة؛ والترميزات القديمة للبرامج القديمة فقط.
LF لأنظمة macOS وLinux ومحررات الأكواد؛ وCRLF لبرامج Windows الأقدم مثل Notepad الكلاسيكي.
الفاصلة هي المعيار. استخدم الفاصلة المنقوطة مع Excel في البلدان التي تكتب الكسور العشرية بفاصلة (ألمانيا وفرنسا والبرازيل).
لمدخلات Excel ذات الأوراق المتعددة: حوّلها كلها (قسم أو ملف لكل ورقة) أو الأولى فقط.
طريقة استخدام هذه الأداة
- 1
ارفع ملفات Word
أضف حتى 20 ملف .docx أو .doc، بحجم أقصاه 95 MB لكل ملف. اقبل التغييرات المتعقَّبة أو ارفضها في Word أولًا، لأن Markdown لا يملك طريقة لعرضها.
- 2
راجع خيارات النص
يكون التنسيق على بسيط، وترميز النص على UTF-8، ونهايات الأسطر على LF، وهي التوليفة التي يتوقعها Git ومولّدات المواقع الثابتة. أبقِ تضمين الصور مفعّلًا لتحصل على الصور في مجلد.
- 3
حوّل الملفات وفك ضغطها
اضغط تحويل إلى MD. يصلك كل مستند في ملف ZIP يضم ملف .md وصوره؛ فُكّ ضغطه في مجلد التوثيق ثم نفّذ commit.
كيف أحوّل مستند Word إلى Markdown؟
ارفع ملف .docx واضغط تحويل إلى MD. تحصل على ملف .md يضم عناوين # وقوائم وروابط وجداول، مع الصور في مجلد بجواره، كل ذلك داخل ملف ZIP واحد.
تحويل DOCX إلى Markdown للتوثيق كرمز (docs-as-code)
تعتمد الفرق نهج docs-as-code لسبب واحد: تصبح التوثيقات بجوار الشيفرة، وتمر عبر طلبات الدمج نفسها وتُصدَر مع الإصدار نفسه. وملف .docx يكسر ذلك، لأنه ملف ZIP من أجزاء XML يخزّنه Git كملف ثنائي مبهم. فتعديل كلمة واحدة يظهر كملف تغيّر بلا فروق مقروءة، ولا يستطيع شخصان يعدّلان معًا دمج عملهما.
Markdown نص عادي، فكل تعديل هو تغيير مرئي في سطر. وصار أكثر قابلية للتوقع في 2014 حين نشر John MacFarlane وآخرون CommonMark، وهو مواصفة دقيقة للصيغة التي وصفها Gruber بشكل فضفاض قبل عشر سنوات. وفي 2017 بنت GitHub مواصفة GitHub Flavored Markdown على CommonMark، وأضافت الجداول بالأعمدة وقوائم المهام والشطب التي تستعملها معظم ملفات README اليوم.
إذا كان المحتوى يسير في الاتجاه المعاكس، أي من Markdown إلى مراجع يعمل في Word، فاستخدم تحويل Markdown إلى DOCX. ولصفحة ويب بدل مستودع، يحافظ تحويل DOCX إلى HTML على قدر أكبر من التنسيق.
كيف يبدو ناتج Markdown
## قائمة التحقق قبل الإصدار قبل وسم الإصدار، تأكد مما يلي: - نجاح الاختبارات على **main** - سجل التغييرات يذكر كل PR مدموج | الخطوة | المسؤول | | --- | --- | | البناء | CI | | النشر | المشرف | 
أين يُعرض ملف Markdown المحوَّل
| الجهة | المتطلب | المصدر |
|---|---|---|
| GitHub | تعرض README.md وأي ملف .md في المستودع باستعمال GitHub Flavored Markdown | github.com |
| Hugo | تبني الصفحات من ملفات المحتوى .md بمحلل متوافق مع CommonMark | gohugo.io |
| Jekyll | تحوّل ملفات .md ذات front matter إلى صفحات؛ وهو المحرك وراء GitHub Pages | jekyllrb.com |
| Docusaurus | تقرأ ملفات .md و.mdx في مجلد docs كصفحات توثيق | docusaurus.io |
DOCX
مستند Microsoft Word
DOCX هو تنسيق المستندات الافتراضي في Microsoft Word منذ Office 2007، ويعتمد على معيار Office Open XML (ECMA-376 وISO/IEC 29500). وهو حزمة ZIP من ملفات XML تحوي النصوص والأنماط والصور والجداول والتعليقات والتغييرات المتتبَّعة. وهو التنسيق الأكثر شيوعًا للمستندات القابلة للتعديل في المكاتب والمدارس وطلبات التوظيف. قد يتغير التخطيط قليلًا بين Word وGoogle Docs وLibreOffice وPages، خاصة مع التنسيق المعقد. تفتح معظم معالجات النصوص ملفات DOCX.
- الضغط
- –
- الشفافية
- –
- الحركة
- –
- سنة الظهور
- 2007 · Microsoft
MD
Markdown
Markdown لغة ترميز خفيفة ابتكرها John Gruber عام 2004. تستخدم رموزًا نصية بسيطة، مثل # للعناوين و* للتأكيد و- للقوائم، تبقى مقروءة كنص خام وتتحول بنظافة إلى HTML. وهي المعيار في ملفات README والتوثيق والويكي وتطبيقات الملاحظات وكثير من مولدات المواقع الثابتة. توجد عدة لهجات منها CommonMark وGitHub Flavored Markdown وتختلف في تفاصيل مثل الجداول. يمكن لأي محرر نصوص فتح ملفات .md.
- الضغط
- –
- الشفافية
- –
- الحركة
- –
- سنة الظهور
- 2004 · John Gruber
يُحوَّل DOCX إلى Markdown عندما ينتقل المستند إلى سير عمل برمجي: ملف README أو موقع توثيق أو قاعدة معرفة محفوظة في Git، حيث يمكن مقارنة النص العادي ومراجعته في طلبات الدمج وعرضه بأدوات كثيرة.
ميزات Word التي لا مقابل لها في Markdown
خطط لهذه الأمور قبل التحويل
- تُحذف الخطوط والألوان وتخطيط الصفحة؛ فـ Markdown يصف البنية، وسمة الموقع تحدد المظهر
- لا تنتقل التغييرات المتعقَّبة والتعليقات، لذا عالجها في Word أولًا
- لا مكان للرؤوس والتذييلات وأرقام الصفحات في ملف .md
- تتحول مربعات النص والصور الملتفّة إلى فقرات عادية وروابط صور
- العناوين التي نسّقتَها يدويًا، كخط عريض 16 pt بدل العنوان 2، تظهر كنص عريض، لذا طبّق أنماط العناوين الحقيقية أولًا
- لا توجد صيغة Markdown للتسطير، فيُحذف أو يبقى بصيغة HTML
أسئلة حول تحويل DOCX إلى Markdown
ما نكهة Markdown التي يتبعها ناتج تحويل DOCX إلى MD؟
تتبع العناوين والتأكيد والقوائم والروابط والشيفرة معيار CommonMark، وتستعمل الجداول صيغة الأعمدة | من GitHub Flavored Markdown. وتعرض GitHub وGitLab وHugo وJekyll وDocusaurus هذه التوليفة جميعها.
ماذا يحدث لخلايا الجدول المدمجة؟
لا تدعم جداول Markdown الخلايا المدمجة، لذا تُقسَّم كل منطقة مدمجة إلى خلايا منفردة يوضع النص في أولاها. أعد بناء الجداول المعقدة بصيغة HTML داخل ملف .md، أو بسّطها في Word قبل التحويل.
أين تذهب الصور الموجودة في مستند Word؟
عند تفعيل تضمين الصور، تُحفظ كل صورة في ملف منفصل داخل ZIP، ويشير إليها Markdown بمسار نسبي مثل images/figure-1.png. أبقِ المجلد بجوار ملف .md عند نقله.
هل تبقى حواشي Word السفلية في Markdown؟
لا يحتوي CommonMark على صيغة للحواشي السفلية، لكن GitHub أضافت حواشي [^1] في 2021 وتدعمها معظم مولّدات المواقع. وإذا لم يدعمها برنامج العرض لديك، يظهر نص الحاشية فقرات عادية في النهاية.
هل يمكنني تحويل Google Docs إلى Markdown بهذه الطريقة؟
نعم. في Google Docs اختر ملف > تنزيل > Microsoft Word (.docx)، ثم ارفع ذلك الملف هنا. كما توفّر Google Docs خيار تنزيل Markdown خاصًا بها، ويناسب المستندات البسيطة.
