كيفية دمج عدة مستندات في ملف Markdown واحد

يحفظ MD Factory ملف Markdown واحدًا لكل مستند. وللحصول على ملف واحد، حوّل المستندات أولًا، ثم اربط ملفات Markdown بأمر PowerShell قصير يضيف سطر مصدر قبل كل ملف.

النتيجة ملف واحد يبدأ فيه كل مستند باسم مصدره. وتظل الصور تعمل، لأن الملف المدمج يقع بجانب مجلدات الصور.

متى يفيد ملف واحد

يفيد ملف واحد عندما تقبل أداة رفعًا واحدًا أو تحدّ من عدد الملفات التي يمكنك إرفاقها، أو عندما تريد قراءة عدة مستندات كنص واحد، أو عندما تريد لصق مجموعة كاملة في موجّه واحد.

أبقِ ملفًا لكل مستند عندما سيبحث وكيل برمجة في المجلد. فيستطيع فتح الملف الذي يحتاج إليه فقط، ويدل اسم الملف على المصدر: راجع كيف تمنح Claude Code وCursor وCodex ملفات PDF وWord. ادمج المستندات التي تنتمي معًا فقط، لأن الملف الطويل جدًا قد يزيد على ما تقرؤه أداة الذكاء الاصطناعي دفعة واحدة.

تحويل المستندات

1. ضع المستندات التي تنتمي معًا في مجلد واحد.
2. افتح MD Factory، وانقر على «إضافة مجلد» واختره. يبدأ التحويل فورًا، ويُحفظ كل ملف Markdown بجانب أصله.
3. انتظر حتى يعرض كل صف «اكتمل» أو «يحتاج إلى مراجعة» أو «فشل». انقر على «يحتاج إلى مراجعة» لقراءة ما يجب التحقق منه، وأصلح تلك الأجزاء قبل ربط الملفات.

يربط الأمر أدناه كل ملف .md في المجلد، لذا حوّل فقط ما تريده في الملف المدمج. احذف النسخ المرقّمة مثل Budget (2).md أولًا إذا لم تردها فيه.

ربط الملفات بواسطة PowerShell

1. في مستكشف الملفات، افتح المجلد الذي يحتوي على ملفات Markdown.
2. انقر على شريط العنوان، واكتب powershell واضغط Enter.
3. الصق هذا الأمر واضغط Enter:

$files = Get-ChildItem -Filter *.md | Where-Object Name -ne "combined.md" | Sort-Object Name
$parts = foreach ($file in $files) {
    "Source file: " + $file.Name + "`n`n" + (Get-Content -LiteralPath $file.FullName -Raw -Encoding utf8)
}
$text = $parts -join "`n`n---`n`n"
[System.IO.File]::WriteAllText("$PWD\combined.md", $text, (New-Object System.Text.UTF8Encoding $false))

النتيجة هي combined.md في المجلد نفسه. تتتابع المستندات بترتيب أبجدي. يبدأ كل منها بسطر مثل Source file: annual-report.md، ويفصله عن المستند السابق خط أفقي.

أبقِ إعدادات UTF-8 في الأمر: فبدونها قد يشوّه Windows PowerShell الأحرف المشكّلة وغير اللاتينية.

لاختيار الترتيب، ضع رقمًا في بداية أسماء ملفات Markdown، مثل 01-contract.md، قبل تشغيل الأمر. وإذا شغّلت الأمر مرة أخرى، يُستبدل combined.md ولا يُقرأ كأحد المستندات.

ربط بعض الملفات فقط

لربط جزء من المجلد، غيّر عامل التصفية في السطر الأول. فمثلًا، لأخذ الملفات التي تبدأ أسماؤها بـ 2026- فقط:

$files = Get-ChildItem -Filter "2026-*.md" | Sort-Object Name

استخدم بقية الأمر كما هو. وإذا أنشأت عدة ملفات مدمجة في مجلد واحد، فامنح كلًا منها اسمًا خاصًا بتغيير combined.md في الأمر.

شكل الملف المدمج

Source file: contract.md

# Supplier contract

...

---

Source file: handbook.md

# Team handbook

نص كل مستند لا يتغير. السطر المصدر والفاصل فقط هما الجديدان.

الصور في الملف المدمج

صور كل مستند في مجلد بجانب ملف Markdown الخاص به، وتشير الروابط في combined.md إلى تلك المجلدات. أبقِ combined.md في المجلد نفسه الذي توجد فيه مجلدات الصور. وإذا نقلته، فانقل معه مجلدات الصور.

يربط الأمر ملفات مجلد واحد. وللمستندات الموجودة في مجلدات فرعية، شغّله في كل مجلد فرعي، ليبقى كل ملف مدمج بجانب صوره.

راجع الملف المدمج

عُدّ أسطر المصدر. يطبع هذا الأمر عدد المستندات في الملف، وهو ما يجب أن يساوي عدد ملفات Markdown:

(Select-String -Path combined.md -Pattern "^Source file: " -Encoding utf8).Count

ثم انظر إلى الملف نفسه:

• افتح combined.md ومرّر إلى الحد بين مستندين. يجب أن يقع الفاصل وسطر المصدر بينهما.
• يحتفظ كل مستند بعناوينه، لذا يحتوي الملف على عدة عناوين من المستوى الأعلى. وتبيّن أسطر المصدر أين يبدأ كل مستند.
• إذا رفضت أداة ذكاء اصطناعي الملف لأنه طويل جدًا، فقسّم المجموعة إلى مجلدين وادمج كلًا منهما.

افتح النتيجة أو ارفعها

تفتح المفكرة الملف combined.md، وكذلك Visual Studio Code الذي يستطيع عرضه منسقًا أيضًا: اضغط Ctrl+Shift+V. وترد تطبيقات أخرى في ما هو ملف MD وكيف تفتحه. وإذا لم يقبل نموذج الرفع ملفات .md، فارفع نسخة أعدت تسميتها إلى combined.txt.

لسرد المستندات في أعلى الملف، اطبع أسطر المصدر والصقها فيه:

Select-String -Path combined.md -Pattern "^Source file: " -Encoding utf8 | ForEach-Object Line

أخبر الذكاء الاصطناعي كيف بُني الملف

تعمل الأداة التي تقرأ combined.md بصورة أفضل عندما تعرف كيف بُني الملف. تكفي تعليمة قصيرة في بداية الموجّه:

اقرأ combined.md. يبدأ كل مستند بسطر
"Source file: name"، ويُنهي خط أفقي
المستند السابق. وعندما تجيب، اذكر ملف
المصدر الذي استخدمته.

قارن بعض الإجابات بالملفات المذكورة. لا يفيد الاسم إلا إذا كان صحيحًا.

عندما يتغير المستند

combined.md نسخة ولا يتبع المستندات. أضف المستند المتغير إلى MD Factory مرة أخرى، ثم شغّل الأمر مرة أخرى.

يحتوي الملف المدمج على نص كل المستندات، فتعامل معه بالعناية نفسها التي تتعامل بها مع الأصول. وإذا كان المجلد يُزامَن مع السحابة، يُزامَن الملف أيضًا: راجع كيفية تحويل المستندات دون رفعها.

أسئلة

هل يستطيع MD Factory دمج المستندات بنفسه؟

لا. يحفظ ملف Markdown واحدًا لكل مستند.

هل يعمل الأمر في PowerShell 7؟

يعمل في Windows PowerShell وفي PowerShell 7.