ViewCSVبعد فتح ملف CSV أو لصقه يظهر جدول بالخطوط العمودية بجوار الخيارات، جاهزًا لملف README أو بلاغ (issue) أو صفحة ويكي. يُكتب الرمز | داخل القيمة بصيغة \| فلا يقسم الخلية أبدًا، وتصبح فواصل الأسطر داخل الخلية <br>، وتُحاذى أعمدة الأرقام إلى اليمين. يُحوَّل الملف في متصفحك ولا يُرفع أبدًا.
طريقة تحويل CSV إلى Markdown
- اختر فتح ملف، أو أفلت ملف
.csv أو .tsv أو .txt على الأداة، أو اختر لصق. يُكتشف المحدِّد تلقائيًا؛ وإذا كان التخمين خاطئًا فاضبطه أو اضبط الترميز أو خيار الصف الأول يحتوي على أسماء الأعمدة من إعدادات الاستيراد. - اختر محاذاة الأعمدة وطريقة كتابة فواصل الأسطر داخل الخلايا. وتعرض علامة التبويب Markdown النص نفسه الذي سيحتويه الملف المنزَّل.
- اختر نسخ للصق الجدول مباشرة في GitHub أو GitLab أو محررك، أو تنزيل Markdown لحفظ ملف
.md.
إذا لم يكن في ملفك صف عناوين، فعطّل الصف الأول يحتوي على أسماء الأعمدة: فجداول Markdown تحتاج دائمًا إلى صف عناوين، فتُسمّى الأعمدة Column 1 وColumn 2 وهكذا. ولعرض البيانات نفسها جدولَ ويب بدلًا من ذلك، استخدم CSV إلى HTML.
خيارات جدول Markdown
| الأرقام إلى اليمين والنص افتراضي | الخيار الافتراضي. لا يُحاذى العمود إلى اليمين (---:) إلا إذا كانت كل قيمه غير الفارغة أرقامًا بسيطة؛ فوجود 00731 أو 12 kg يُبقي العمود بالمحاذاة الافتراضية لأداة العرض. |
|---|---|
| افتراضي (بلا محاذاة)، إلى اليسار، في الوسط، إلى اليمين | تطبيق محاذاة واحدة على كل الأعمدة: --- أو :--- أو :---: أو ---: في صف الفاصل. |
| إبقاؤها بصيغة <br> | يصبح فاصل السطر داخل الخلية <br>، الذي يعرضه GitHub وأغلب أدوات العرض سطرًا جديدًا داخل الخلية. وهذا هو الافتراضي. |
| استبدالها بمسافة | يصبح كل فاصل سطر مسافة واحدة، لأدوات العرض التي تحذف HTML. |
| تهريب أحرف Markdown | مفعّل افتراضيًا. تُسبق الأحرف * و_ و[ و] و< و> و# و~ وعلامة الاقتباس المائلة بشرطة مائلة عكسية، فتظهر قيمة مثل *fast* أو <b> كما كُتبت بدل أن تصبح تنسيقًا أو HTML. ولا يُعطَّل إلا إذا كانت الخلايا تحمل Markdown تريد عرضه منسَّقًا. |
| محاذاة الأعمدة في النص المصدر | مفعّل افتراضيًا. يملأ الخلايا بمسافات ليُقرأ ملف .md الخام كشبكة. وتُحسب الأحرف العريضة مثل الصينية واليابانية والكورية عمودين. ويُعطَّل للحصول على أصغر ناتج؛ ويبدو الجدول المعروض كما هو. |
الخطوط العمودية وفواصل الأسطر والأصفار في البداية
- يُهرَّب الخط العمودي والشرطة المائلة العكسية دائمًا (
\|، \\)، حتى مع تعطيل تهريب أحرف Markdown، لأن | غير المهرَّب يبدأ خلية جديدة. - تُقرأ الفواصل وفواصل الأسطر داخل علامات الاقتباس وفق RFC 4180، فتبقى
"Cable tidy, 3-pack" في خلية واحدة. وتُعدّ في ملاحظة فوق المعاينة كل قيمة احتوت على فاصل سطر. - تُكتب القيم نصًا: تحتفظ
00731 بأصفارها و34.90 بصفرها الأخير. ولا يُقرَّب شيء ولا يُعاد تنسيقه. - يصبح العنوان الفارغ
Column 3 والمكرر name (2)، فيكون لكل عمود عنوان مميز. - تزيل أدوات عرض Markdown المسافات من بداية الخلية ونهايتها، ولا يمكن أن يحتوي الجدول على قوائم أو فقرات؛ لذا يُحفظ هذا المحتوى في مستند منفصل.
حين يُعرض جدول Markdown بشكل خاطئ
- النص بعد الجدول ينضم إلى صفه الأخير. لا ينتهي الجدول إلا بسطر فارغ أو ببداية كتلة أخرى، لذا اترك سطرًا فارغًا بعده.
- كل القيم في عمود واحد. خُمِّن المحدِّد خطأً. اختر فاصلة أو فاصلة منقوطة أو علامة جدولة أو خطًا عموديًا من «إعدادات الاستيراد» وافتح الملف من جديد.
- **تظهر شرطات مائلة عكسية قبل * أو _ في النتيجة.** هذا أثر التهريب في أداة عرض تتجاهله. عطّل «تهريب أحرف Markdown» إذا لم تكن في بياناتك أحرف تنسيق تحتاج إلى حماية.
- تظهر فواصل الأسطر وسمًا حرفيًا. أداة العرض لا تسمح بـ HTML. اختر «استبدالها بمسافة» تحت «فواصل الأسطر داخل الخلايا».
الحدود والخصوصية
الملفات حتى 25 ميغابايت أو 100 ألف صف أو مليوني خلية تُفتح مع معاينة مباشرة لأول 200 صف. أما الملفات الأكبر فتُحوَّل تدفقيًا: يُقرأ الملف مرتين على أجزاء (مرة لقياس الأعمدة وعروضها، ومرة للكتابة)، وتذكر ملاحظة أن الملف المنزَّل يشمل الملف كله، ولا يتوفر نسخ. والحد الأقصى لملف الناتج الواحد 4 غيغابايت.
يجري التحويل في عامل خلفي داخل علامة التبويب هذه، فتبقى الصفحة مستجيبة ويوقفه زر إلغاء. ولا يُرسل ملف CSV أبدًا إلى أي خادم. ولفحص ملف كبير قبل تحويله، افتحه في عارض CSV.
مثال: قائمة منتجات في جدول Markdown
قائمة منتجات فيها رمز SKU مسبوق بصفر، وخط عمودي داخل اسم، وفاصلة داخل علامتي اقتباس، وملاحظة من سطرين، حُوّلت بالإعدادات الافتراضية. يُحاذى price إلى اليمين لأن كل قيمه أرقام؛ أما sku فلا، لأن 00731 تبقى نصًا.
sku,name,price,note 00731,"Desk lamp | brass",34.90,"Ships in 2 days from Leeds" 00732,"Cable tidy, 3-pack white",4.50,Back-ordered until 14 March 2025 00733,USB-C hub,129.00,
| sku | name | price | note | | ----- | ------------------------ | -----: | -------------------------------- | | 00731 | Desk lamp \| brass | 34.90 | Ships in 2 days<br>from Leeds | | 00732 | Cable tidy, 3-pack white | 4.50 | Back-ordered until 14 March 2025 | | 00733 | USB-C hub | 129.00 | |
أسئلة وأجوبة
هل يعمل الناتج على GitHub؟
نعم. هو جدول بالخطوط العمودية وفق Markdown بنكهة GitHub: صف عناوين، وصف فاصل فيه نقطتان اختياريتان للمحاذاة، وسطر لكل صف CSV. وتقرأ GitLab وObsidian وأغلب مولّدات المواقع الثابتة الصيغة نفسها.
لماذا أرى `\|` في النص المصدر؟
الرمز | العادي ينهي الخلية في جدول Markdown. والشرطة المائلة العكسية تطلب من أداة العرض إظهار الخط العمودي نصًا، فتبقى Desk lamp | brass في خلية واحدة.
هل يمكن تحويل جدول Markdown إلى CSV؟
ليس في هذه الصفحة. فهي تحوّل ملفات CSV وTSV إلى Markdown فقط.