كيفية تحويل CSV إلى MD
- الصق نص CSV أو قم بتحميل ملف
.csvمدعوم. - تأكد من الفاصل وحرف الاقتباس وصف الرأس وترميز الأحرف.
- عاين الصفوف التي تم تحليلها وجدول Markdown الناتج.
- انسخ الجدول أو قم بتنزيل ملف
.md.
ما الذي يحافظ عليه المحول؟
| المحتوى المصدر | سلوك الإخراج الموصى به | ملاحظة التحويل |
|---|---|---|
| صف الرأس | استخدم الصف الأول أو الصف المحدد كعناوين | |
| الصفوف والأعمدة | الحفاظ على البيانات المستطيلة التي تم تحليلها | |
| فواصل مقتبسة | الاحتفاظ بالفواصل أو الفواصل داخل الحقول المقتبسة | |
| اقتباسات مهربة | فك ترميز أحرف الاقتباس المزدوجة بشكل صحيح | |
| حقول فارغة | عرض خلايا فارغة | |
| أسطر جديدة في الحقول | تهريبها أو استبدالها أو استخدام فواصل HTML | |
| أحرف الأنابيب | تهريبها بحيث تظل خلايا GFM صالحة | |
| المحاذاة | إنشاء محاذاة أعمدة اختيارية |
ما الذي قد يتغير أثناء التحويل؟
محتوى الخلايا متعدد الأسطر والغني
خلايا جدول Markdown لها دعم محدود لفواصل الأسطر والقوائم ومحتوى الكتل.
مجموعات بيانات كبيرة جدًا
يمكن أن تنتج آلاف الصفوف جدول Markdown صالحًا تقنيًا ولكن يصعب قراءته. راجع الإخراج قبل نشره.
ترميز الأحرف
قد تظهر الملفات المشفرة بـ Windows-1252 أو Shift_JIS أو ترميز آخر بشكل غير صحيح إذا تم فك ترميزها كـ UTF-8.
صفوف غير منتظمة
الصفوف ذات أعداد الحقول المختلفة تحتاج إلى خطأ أو قاعدة إصلاح أو سياسة حشو صريحة.
أنواع البيانات
لا يحافظ CSV بطبيعته على الأنواع الرقمية أو التاريخية أو المنطقية؛ يقدم Markdown النص.
استخدامات شائعة لتحويل CSV إلى Markdown
إضافة بيانات إلى README
قم بتحويل مصفوفة توافق مضغوطة أو قائمة ميزات إلى جدول مُدار بالإصدارات.
مشاركة نتائج الاستعلام
الصق تصديرًا صغيرًا في مشكلة أو طلب سحب أو تذكرة دعم.
توثيق حقول API
قم بتحويل مخطط أو قائمة حقول مخزنة في CSV إلى جدول مرجعي قابل للقراءة.
نقل الملاحظات الجدولية إلى Obsidian
أنشئ جدول نصي محمول مع الاحتفاظ بـ CSV لمزيد من الحسابات.
مثال على تحويل CSV إلى Markdown
name,description,status
Alpha,"Fast, simple",active
Beta,"A | B",paused| name | description | status |
|---|---|---|
| Alpha | Fast, simple | active |
| Beta | A \| B | paused |نصائح لإخراج Markdown أنظف
- تأكد من الفاصل قد تبدو الملفات المفصولة بفواصل أو فاصلة منقوطة أو علامة تبويب متشابهة في معاينة نص عادي.
- استخدم محلل CSV حقيقي تقسيم السلسلة البسيط يكسر الفواصل المقتبسة والاقتباسات المهربة والحقول متعددة الأسطر.
- حدد عدد الصفوف للتوثيق الجدول المختصر أكثر فائدة من لصق مجموعة البيانات بأكملها.
- تحقق من الترميز قبل التحويل أصلح الأحرف المشوشة في خطوة فك الترميز بدلاً من بعد إنشاء Markdown.
- عاين الأنابيب وفواصل الأسطر يمكن لهذه الأحرف كسر بنية الجدول إذا لم يتم تهريبها باستمرار.
الأسئلة الشائعة
هل يصبح الصف الأول من CSV رأس الجدول؟
يصبح أول صف ممتلئ رأس جدول Markdown. قم بإعداد صف رأس قبل التحويل عندما يبدأ CSV مباشرة بالبيانات.
هل يتم تهريب أحرف الأنابيب تلقائيًا؟
نعم. يتم تهريب أحرف الأنابيب بحيث تبقى داخل خلية GFM الصحيحة.
كيف يتم التعامل مع الفواصل داخل الحقول المقتبسة؟
تبقى الفواصل المقتبسة داخل نفس الخلية. يتعامل محلل CSV أيضًا مع أحرف الاقتباس المهربة.
ماذا يحدث لخلايا CSV متعددة الأسطر؟
تصبح فواصل الأسطر داخل الخلية <br>. هذا يحافظ على استطالة الصف في Markdown بنكهة GitHub.
هل يمكنني استخدام الفواصل المنقوطة أو علامات التبويب كفواصل؟
نعم. يدعم اكتشاف الفاصل الفواصل والفواصل المنقوطة وعلامات التبويب والأنابيب.
هل يتم الحفاظ على الخلايا الفارغة؟
نعم. تبقى الخلايا الفارغة فارغة ولا تغير القيم في الأعمدة اللاحقة.
هل يمكن محاذاة الأعمدة الرقمية إلى اليمين؟
يمكن لعلامات محاذاة GFM التعبير عن المحاذاة لليسار أو الوسط أو اليمين.
ما هو الحجم الأقصى لملف CSV؟
لا يفرض المحول حدًا ثابتًا لحجم الملف. قد تستغرق ملفات CSV الكبيرة جدًا وقتًا أطول للمعالجة، وقد تكون جداول Markdown الخاصة بها غير عملية للقراءة، لذا راجع المخرجات الكبيرة قبل نشرها.
تحويل Markdown مرة أخرى إلى PDF
هل لديك بالفعل ملف Markdown؟ استخدممحول Markdown إلى PDFلإنشاء PDF قابل للمشاركة.