طريقة الاستخدام
- اختر اتجاه التحويل: من CSV أو TSV إلى جدول Markdown، أو من جدول Markdown إلى CSV.
- الصق النص في النص المراد تحويله. في CSV يكون الصف الأول هو عنوان الجدول.
- تحت محاذاة الأعمدة، أبقِ تلقائي الذي يضع الأرقام على اليمين، أو اختر جهة واحدة لكل الأعمدة.
- انسخ جدول Markdown أو CSV، أيهما يعطيه الاتجاه الذي اخترته.
صيغة جدول Markdown
للجدول في امتداد الجداول في GitHub Flavored Markdown صف عناوين، وصف فاصل، وصفوف بيانات. تُكتب الخلايا بين الأنابيب، ويحتوي صف الفاصل على خلية لكل عمود، مكونة من شرطات مع نقطتين اختياريتين في أي طرف. وتنص مواصفة GFM على أن يكون لصف الفاصل عدد الخلايا نفسه في صف العناوين. والنقطتان على اليسار تحاذيان العمود إلى اليسار، والنقطتان على اليمين تحاذيانه إلى اليمين، والنقطتان على الجانبين تجعلانه في الوسط.
صف البيانات الذي فيه خلايا أقل من صف العناوين يحصل على خلايا فارغة. والصف الذي فيه خلايا أكثر تُتجاهل خلاياه الزائدة. ويُكتب الأنبوب داخل الخلية بشرطة مائلة عكسية أمامه، فيحتفظ به العارض داخل الخلية.
| عنوان | عنوان | ثم | --- | ---: | ثم | بيانات | بيانات |
عرض الأعمدة والأرقام والتهريب
يكون كل عمود بعرض أوسع خلاياه، بحد أدنى ثلاثة أحرف، فيكون كل سطر من الجدول المصفوف بالطول نفسه. ويُحاذى العمود الذي تكون كل خلاياه المملوءة أرقاماً إلى اليمين، فتسهل مقارنة الأرقام. ويُحسب العرض بالأحرف، لذلك قد لا يصطف الحرف العريض تماماً.
يجب أن يكون صف الجدول سطراً واحداً، لذلك يُكتب فاصل السطر داخل خلية CSV مسافة. ويتبع قراءة CSV القواعد المعتادة: الخلية التي تحمل فاصلة أو علامة اقتباس تُحاط بعلامتي اقتباس، وتُضاعف علامة الاقتباس داخلها.
- اختر الفاصل بنفسك حين يخطئ الكشف التلقائي؛ فجداول البيانات العربية تستخدم الفاصلة المنقوطة كثيراً.
- أوقف اصطفاف الأعمدة حين يكون Markdown طويلاً ويهم حجم الملف أكثر من تخطيط النص الخام.
مثال محلول: قائمة أسعار فيها أنبوب في أحد الأسماء
يحتوي CSV على العناوين المنتج والسعر والمخزون، والصفوف شاي و12.5 و40، وقهوة | حبوب و85 و12. الخلية قهوة \| حبوب عرضها 12 حرفاً بعد تهريب الأنبوب، فيكون عمود المنتج 12 حرفاً، ويكون عمودا السعر والمخزون 5 و7 حروف، لأن أرقامهما تُحاذى إلى اليمين.
صف الفاصل هو ------------ للمنتج، و----: للسعر، و------: للمخزون. ويكون صف قهوة \| حبوب متبوعاً بـ 85 و12 مُحاذاة إلى اليمين. وفي الجدول صفان من البيانات وثلاثة أعمدة.
الأسئلة الشائعة
لماذا يحتاج الأنبوب داخل الخلية إلى شرطة مائلة عكسية؟
الأنبوب هو فاصل الأعمدة في جدول Markdown، فالأنبوب المكشوف داخل خلية يبدأ عموداً جديداً. والشرطة المائلة العكسية أمامه تُبقيه داخل الخلية، ويعرض الجدول المعروض أنبوباً واحداً.
هل تغيّر المسافات المضافة للاصطفاف شكل الجدول؟
لا. تتجاهل المتصفحات المسافات حول نص الخلية، فيبدو الجدول كما هو. وتجعل المسافات Markdown الخام أسهل قراءة في المحرر فقط.
لماذا تُحاذى أعمدة الأرقام إلى اليمين؟
تسهل مقارنة الأرقام عندما تصطف خاناتها الأخيرة، لذلك تضع المحاذاة التلقائية عموداً من الأرقام على اليمين. ويبقى العمود الذي فيه أي نص على اليسار.
ماذا يحدث لفاصل السطر داخل خلية CSV؟
يجب أن يكون صف الجدول في سطر واحد، لذلك تكتب الأداة فاصل السطر داخل الخلية مسافة. ويبقى نص الخلية كما هو، إلا تلك المسافة.
أين تُعرض جداول Markdown بشكل صحيح؟
يعرضها GitHub ومعظم أدوات Markdown التي تتبع امتداد الجداول في GFM. وبعض عارضات Markdown البسيطة لا تملك صيغة جداول أصلاً، لذلك تحقق من المكان الذي ستنشر فيه الجدول.
هل يُرسل النص الذي ألصقه أو يُحفظ في أي مكان؟
لا. يُصنع الجدول وملف CSV في متصفحك. ولا يُخزَّن شيء ولا يُرسل إلى خادمنا، لذلك انسخ النتيجة قبل أن تغادر الصفحة.
المصادر
- GitHub Flavored Markdown Spec (باللغة الإنجليزية): tables extension
- IETF (باللغة الإنجليزية): RFC 4180, Common Format and MIME Type for CSV Files
آخر مراجعة للأرقام والنص: الثلاثاء، 30 جمادى الأولى 1448 بعد الهجرة.