Pandoc Word إلى Markdown: دليل تحويل سطر الأوامر

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

ما هو (باندوك) ؟

Pandoc هو أداة مجانية مفتوحة المصدر لسلسلة الأوامر التي تحويل المستندات بين التنسيقات. وهو يدعم أكثر من 40 تنسيق إدخال وإخراج. ل Word إلى Markdown التحويل، Pandoc هو معيار الذهب أكثر قابلية للتهيئة من أي أداة تستند إلى المتصفح، بما في ذلك WordToMD.

متى تستخدم Pandoc مقابل WordToMD:

تثبيت Pandoc

النوافذ

تحميل برنامج التثبيت من pandoc.org/التثبيت.html، أو استخدم مدير حزم:

# Winget
winget install pandoc

# Chocolatey
choco install pandoc

# Scoop
scoop install pandoc

ماكوس

# Homebrew
brew install pandoc

# MacPorts
sudo port install pandoc

لينكس

# Ubuntu/Debian
sudo apt-get install pandoc

# Fedora
sudo dnf install pandoc

# Arch
sudo pacman -S pandoc

التحقق من التثبيت:

pandoc --version

أوامر التحويل الأساسية

pandoc document.docx -o output.md

هذا كل شيء Pandoc يستنتج شكل الإدخال من .docx وتنسيق الخروج من .md.

النسخة الأكثر وضوحاً:

pandoc -f docx -t markdown document.docx -o output.md

خيارات تنسيق الناتج

Pandoc يقدم عدة Markdown متغيرات كمخرج:

# GitHub Flavored Markdown (GFM)
pandoc document.docx -t gfm -o output.md

# CommonMark
pandoc document.docx -t commonmark -o output.md

# Pandoc's extended Markdown (most features)
pandoc document.docx -t markdown -o output.md

# Standard Markdown (basic)
pandoc document.docx -t markdown_strict -o output.md

يوصى بـ GFM في معظم حالات الاستخدام (GitHub, Obsidian, GitBook, Notion).

خيارات التحويل المفيدة

استخراج ملفات الوسائط

الصور المضمنة في .docx يتم استخراجها إلى دليل:

pandoc document.docx --extract-media=./media -o output.md

هذا يحفظ الصور إلى ./media/ ويضيف إشارات صورة Markdown إلى الناتج.

خطوط التفاف

تغليف خط التحكم في المخرج:

# No wrapping (one paragraph = one line)
pandoc document.docx --wrap=none -o output.md

# Wrap at 80 characters
pandoc document.docx --wrap=auto --columns=80 -o output.md

--wrap=none يوصى بـ Markdown التي ستكون خاضعة لسيطرة الإصدار فإنها تنتج اختلافات Git النظيفة.

جدول المحتوى

pandoc document.docx --toc -o output.md

وثيقة مستقلة مع البيانات الوصفية

pandoc document.docx -s -o output.md

المجلس -s (مستقل) العلم يولد YAML المادة المقدمة من الميتاداتا الوثيقة.

تحويل الدفعات

تحويل جميع ملفات .docx في الدليل:

ويندوز باور شيل

Get-ChildItem -Filter "*.docx" | ForEach-Object {
    $output = [System.IO.Path]::ChangeExtension($_.Name, ".md")
    pandoc $_.FullName -t gfm --wrap=none -o $output
    Write-Host "Converted: $($_.Name) → $output"
}

Bash (ماكوس/لينكس)

for file in *.docx; do
    output="${file%.docx}.md"
    pandoc "$file" -t gfm --wrap=none -o "$output"
    echo "Converted: $file → $output"
done

لمزيد من خيارات تحويل الدفعات، انظر تحويل الدفعة Word إلى Markdown.

تخصيص المخرجات باستخدام مرشحات Lua

Pandoc يدعم مرشحات Lua التي تحويل الوثيقة AST أثناء التحويل:

pandoc document.docx --lua-filter=my-filter.lua -o output.md

مثال تصفية Lua لإضافة كتلة مادة مقدمة مخصصة:

-- add-frontmatter.lua
function Meta(meta)
  meta.draft = false
  meta.author = "WordToMD Team"
  return meta
end

هذا هو نوع التخصيص الذي لا يمكن أن تتطابق أدوات المتصفح.

مقارنة Pandoc و.js المخرجات

WordToMD يستخدم الماموث تحت غطاء السيارة Pandoc يستخدم المحلل الخاص به. الاختلافات الرئيسية:

للوثائق المعقدة، Pandoc يعطي خروجا أكثر اكتمالا. للوثائق البسيطة ، WordToMD أسرع مع إعداد صفر.

Pandoc الملفات الافتراضية

لتحويلات متكررة بنفس الإعدادات، قم بإنشاء ملف افتراضي:

# my-defaults.yaml
from: docx
to: gfm
wrap: none
extract-media: ./media
standalone: true

ثم تشغيل:

pandoc document.docx -d my-defaults.yaml -o output.md

استخدام Pandoc في CI/CD

بالنسبة إلى خطوط الأنابيب الآلية (GitHub الإجراءات، وما إلى ذلك):

# .github/workflows/convert-docs.yml
- name: Install Pandoc
  run: sudo apt-get install pandoc

- name: Convert Word docs to Markdown
  run: |
    for f in docs/*.docx; do
      pandoc "$f" -t gfm --wrap=none -o "${f%.docx}.md"
    done

FAQ

Pandoc المخرجات \ استمرارية الخط في Markdown كيف يمكنني إزالتها؟ إضافة --wrap=none لتعطيل التفاف الصلب.

جداولى تبدو مشوشة فى Pandoc الخروج. حاولي -t gfm لـ GFM الجدول اللفظي بدلاً من الجداول Pandoc Markdown الافتراضية.

الصور لا تظهر في الخروج. إضافة --extract-media=./images لاستخراج الصور المضمنة. ثم إشارة لهم بشكل صحيح في البيئة المستهدفة الخاصة بك.

Pandoc يحول الاقتباسات الذكية إلى " كيف أبقيهم؟ إضافة --no-highlight أو تعديل النموذج. بالنسبة إلى الاقتباسات الذكية على وجه التحديد ، يجب الحفاظ عليها بشكل افتراضي في معظم تنسيقات الإنتاج.

كيف يتقارن Pandoc و WordToMD في DOCX مع Markdown؟ كلاهما يعمل جيداً في الوثائق القياسية. WordToMD يتطلب إعداد صفر و ينتج صافي GFM الخروج. Pandoc يتطلب التثبيت ولكنه يتعامل مع المستندات المعقدة (الصور، الرياضيات، التعليقات، الملاحظات السفلية) بشكل أكثر اكتمالاً.

النتيجة

Pandoc هو الأداة الأكثر قدرة على Word إلى Markdown التحويل، وخاصة لمعالجة الدفعات، وتشكيلات الإنتاج المخصصة، وخطوط أنابيب CI/CD. لتحويلات سريعة ووحيدة بدون تركيب WordToMD يقوم بعمله على الفور الأدوات الثنائية تكمّل بعضها البعض بشكل جيد.