لتحويل ملف TXT إلى Markdown، يكفي غالبًا تغيير امتداده من .txt إلى .md. فـ Markdown نص عادي، ولذلك فإن ملف النص مستند Markdown صالح أصلًا.
لا توجد في النص العادي عناوين أو نص غامق أو جداول لاستعادتها، ولن يخترعها المحوّل. ويفيد التحويل بـ MD Factory في حالات أخرى: أن يكون الملف بترميز قديم مثل Windows-1251، أو أن تشترك ملفات TXT في مجلد واحد مع مستندات PDF وWord، أو أن يلزم أن تكون كل ملفات مكتبة مخصصة لوكيل ذكاء اصطناعي بالشكل نفسه.
متى يكفي تغيير الاسم
يصلح تغيير الاسم عندما يكون النص بترميز UTF-8 ولا يحتاج شيء آخر إلى الملف باسمه القديم. وتنص مواصفات CommonMark لـ Markdown على أن أي تسلسل من الأحرف مستند صالح.
لمعرفة الترميز، افتح الملف في المفكرة وانظر إلى الزاوية السفلية اليمنى من شريط الحالة. إذا كان UTF-8 فيمكنك تغيير اسم الملف. وأي ترميز آخر، مثل ANSI أو UTF-16، يجب أن يصبح UTF-8 أولًا، وتبيّن الأقسام أدناه كيف. وANSI هو ترميز قديم في Windows، مثل Windows-1251 للسيريلية أو Windows-1252 للغات أوروبا الغربية.
لتغيير اسم ملف واحد، فعّل إظهار امتدادات أسماء الملفات في مستكشف الملفات: عرض، ثم إظهار، ثم امتدادات أسماء الملفات. بعد ذلك غيّر نهاية الاسم من .txt إلى .md ووافق عندما يسأل Windows عن تغيير الامتداد. وكما تذكر Microsoft، فإن الامتداد الجديد يغيّر الاسم فقط لا المحتوى.
لعدد كبير من الملفات، افتح PowerShell في مجلدها. هذا الأمر يعرض فقط ما سيعيد تسميته:
Get-ChildItem -Filter *.txt | Rename-Item -NewName { $_.BaseName + '.md' } -WhatIf
إذا كانت القائمة صحيحة، شغّل الأمر نفسه دون الجزء الأخير:
Get-ChildItem -Filter *.txt | Rename-Item -NewName { $_.BaseName + '.md' }
ولتشمل المجلدات الفرعية، استخدم الأمرين نفسيهما مع معامل إضافي واحد:
Get-ChildItem -Filter *.txt -Recurse | Rename-Item -NewName { $_.BaseName + '.md' } -WhatIf
Get-ChildItem -Filter *.txt -Recurse | Rename-Item -NewName { $_.BaseName + '.md' }
إذا كان برنامج آخر يفتح هذه الملفات بأسمائها القديمة، فانسخها قبل تغيير الأسماء.
متى يستحق التحويل
| الحالة | بعد تغيير الاسم | بعد التحويل بـ MD Factory |
|---|---|---|
| النص بترميز Windows-1251 أو ترميز قديم آخر | يبقى النص بذلك الترميز؛ وأي تطبيق يقرأ الملف على أنه UTF-8 يعرض أحرفًا مشوّهة | يُحفظ النص بترميز UTF-8، ويحمل الملف علامة «يحتاج إلى مراجعة» لتتحقق منه |
| ملفات TXT في المجلد نفسه مع مستندات PDF وWord وغيرها | تتغير ملفات TXT فقط؛ أما المستندات الأخرى فتحتاج إلى أداة أخرى | مرور واحد على المجلد ومجلداته الفرعية؛ ويحصل كل مستند على ملف Markdown بجانبه |
| يجب أن تبقى الملفات الأصلية كما هي | يتحول ملف TXT إلى ملف Markdown | يبقى ملف TXT دون تغيير، ويظهر ملف Markdown بجانبه |
| يحتاج نص برمجي أو وكيل ذكاء اصطناعي إلى أن تكون كل الملفات بالشكل نفسه | يحتفظ كل ملف بترميزه ونهايات أسطره | لكل ملف Markdown الترميز نفسه ونهايات الأسطر نفسها |
ولمجلد فيه صيغ كثيرة، راجع كيفية تحويل المستندات إلى Markdown دفعة واحدة. ولترتيب النتيجة لوكيل ذكاء اصطناعي، راجع كيفية تجهيز المستندات لوكلاء الذكاء الاصطناعي.
ماذا يفعل MD Factory بملف TXT
أضف ملفات TXT أو مجلدها بـ «إضافة ملفات» أو «إضافة مجلد»، أو أفلتها على النافذة. يبدأ التحويل فورًا، ويُحفظ كل ملف Markdown بجانب ملف TXT الخاص به. وينسخ MD Factory النص كما هو: فلا يضيف عناوين ولا قوائم ولا يعيد كتابة شيء.
- يُقرأ النص بترميز UTF-8، أو مع علامة ترتيب البايتات، كما هو. ويحصل الملف على حالة «اكتمل».
- يُتعرَّف على النص بترميز أقدم من محتواه ويُحفظ بترميز UTF-8. ويحصل هذا الملف دائمًا على «يحتاج إلى مراجعة»، مع الرسالة «تم استنتاج ترميز النص. تحقق من الأحرف الخاصة.»
- إذا تعذّر تحديد الترميز، يفشل الملف مع الرسالة «لا يمكن قراءة ترميز النص بشكل موثوق.»
- ملف Markdown دائمًا بترميز UTF-8 دون علامة ترتيب البايتات، ونهايات أسطره LF.
- تبقى الأحرف التي يقرؤها Markdown على أنها تنسيق كما هي. فالسطر الذي يبدأ بـ # ومسافة يصبح عنوانًا في عارض Markdown، والكلمة بين نجمتين تصبح مائلة.
- تُحوَّل الملفات المنتهية بـ .txt فقط. أما الملفات مثل .log أو .ini فتظهر بحالة «تم التخطي»؛ غيّر اسمها إلى .txt لتحويلها، أو مباشرة إلى .md.
- يفشل ملف TXT الأكبر من 64 MB مع الرسالة «يتجاوز هذا المستند حدود المعالجة الحالية.» قسّمه إلى ملفات أصغر، أو غيّر اسمه بدلًا من ذلك.
تحقق من الملفات ذات الترميز المخمَّن
افتح كل ملف يحمل «يحتاج إلى مراجعة» وانظر إلى الأحرف الواقعة خارج الأبجدية الإنجليزية: الأحرف السيريلية والأحرف المشكّلة وعلامات الاقتباس المنحنية والشرطات.
يُتعرَّف عادةً على النص السيريلي بترميز Windows-1251 أو KOI8-R أو DOS 866 بشكل صحيح إذا كان في الملف جملة على الأقل.
نصوص أوروبا الغربية بترميز Windows-1252 هي نقطة الضعف. فغالبًا ما يعدّها MD Factory بترميز Windows-1250 لأوروبا الوسطى، فتتغير بعض الحروف: è تصبح č، وñ تصبح ń، وã تصبح ă.
وإذا كانت هذه الأحرف نادرة في الملف، مثل بضعة أسماء بحروف مشكّلة أو علامات اقتباس منحنية في نص إنجليزي، فإنها تتحول إلى العلامة �.
ملف TXT نفسه لا يتغير، فيمكنك إصلاحه وتحويله مرة أخرى. احفظ الملف فقط عندما يبدو نصه صحيحًا: فحفظ نص مشوّه بترميز UTF-8 يجعل التلف دائمًا. وإذا كان الملف مهمًا، فاعمل على نسخة.
- افتح ملف TXT في المفكرة. إذا بدا النص صحيحًا، فاختر «ملف» ثم «حفظ باسم»، واضبط «الترميز» على UTF-8 واحفظ.
- إذا بدا النص خاطئًا في المفكرة أيضًا، فافتح الملف في Visual Studio Code. انقر على الترميز في شريط الحالة، واختر «Reopen with Encoding» ثم الترميز الصحيح، مثل Western (Windows 1252). ثم انقر على الترميز مرة أخرى واحفظ الملف بترميز UTF-8.
- في MD Factory، امسح القائمة بزر «مسح» وأضف الملف مرة أخرى. أو غيّر اسمه ببساطة إلى .md: فبترميز UTF-8 لم يعد بحاجة إلى التحويل.
يستبدل MD Factory نتيجته السابقة إذا لم تكن قد حرّرتها. وإذا كنت قد حرّرتها، تُحفظ النتيجة الجديدة برقم، مثل notes (2).md.
أضف العناوين والقوائم بنفسك
لا يحدد النص العادي أي سطر هو عنوان، لذا فالبنية عليك. افتح ملف Markdown في أي محرر نصوص واكتب هذه العلامات في بداية السطر:
| للحصول على | ابدأ السطر بـ |
|---|---|
| عنوان | # ثم مسافة؛ و## لعنوان فرعي، و### للمستوى الذي تحته |
| عنصر في قائمة نقطية | - ثم مسافة |
| عنصر في قائمة مرقّمة | 1. ثم مسافة |
| فقرة جديدة | سطر فارغ قبلها |
قد يظهر فاصل سطر واحد داخل الفقرة مسافةً: فمواصفة CommonMark تسمح بالأمرين. وحيث تهم فواصل الأسطر، كما في العناوين البريدية أو القصائد، أنهِ كل سطر بشرطة مائلة عكسية أو ضع سطرًا فارغًا بين الأسطر.
لمنع حرف من التحول إلى تنسيق، ضع شرطة مائلة عكسية قبله: \# في بداية السطر تعرض # عادية. ويسرد دليل GitHub حول صيغة الكتابة والتنسيق الأساسية العلامات الأخرى.
يستطيع وكيل ذكاء اصطناعي إضافة البنية عنك. اطلب منه الإبقاء على الكلمات والكتابة في ملف جديد:
أضف عناوين Markdown وقوائم إلى notes.md.
لا تغيّر أي كلمة ولا تضف ولا تحذف.
احفظ النتيجة باسم notes-formatted.md واترك notes.md دون تغيير.
قارن بين الملفين قبل أن تحتفظ بالجديد. ولرؤية النتيجة بتنسيقها، اقرأ كيفية فتح ملف MD على Windows.