كيف تحول البيانات إلى جداول Markdown

جدول Markdown ليس جدول بيانات مصغراً. في GitHub Flavored Markdown هو كتلة نصية موجزة تتكون من صف رأس وصف فاصل وصفوف بيانات اختيارية. تفصل الأنابيب بين الخلايا، وتطلب النقطتان في صف الفاصل المحاذاة إلى اليسار أو الوسط أو اليمين. هذه البساطة مفيدة لملفات README ووصف المشكلات، لكنها تعني أيضاً أن أنبوباً أو فاصلاً سطرياً داخل البيانات قد يغير شكل الجدول دون قصد.

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

استورد أو الصق عينة صغيرة مقصودة، وتحقق من حدود الصفوف والأعمدة، ثم سمِّ خلايا الرأس. طبّق المحاذاة بعد ثبات شكل البيانات. اهرب الأنبوب الذي ينتمي إلى المحتوى بدلاً من معاملته كفاصل، وحوّل فواصل الأسطر داخل الخلية إلى تمثيل تقبله الوجهة. أنشئ Markdown، وافحص صف الفاصل الخام، ثم اعرضه في معاينة متوافقة مع GFM قبل تطبيق الخيارات نفسها على البيانات الكاملة.

تأتي قواعد الجدول وعلامات المحاذاة وسلوك المحتوى السطري ومنع العناصر الكتلية من مواصفة GitHub Flavored Markdown، لا من CommonMark الأساسي.

استخدم ثلاثة أعمدة: الأمر والنتيجة والملاحظة. أدخل `pnpm test | tee test.log` كأول أمر، و`ناجح` كنتيجته، وملاحظة من سطرين. يجب أن يصبح الأنبوب الحرفي في الأمر `\|` داخل مصدر الجدول حتى يبقى في خلية واحدة. قرر هل يتحول فاصل الملاحظة إلى `<br>` لوجهة GitHub أم إلى مسافة لقابلية نقل أعلى. اجعل عمود النتيجة في الوسط وتحقق من ظهور `:---:` تحته في صف الفاصل.

في جدول GFM صالح يجب أن يساوي عدد خلايا الرأس عدد خلايا الفاصل. قد يملأ العارض صفوف البيانات أو يقصها، لكن توحيد كل صف إلى عدد الأعمدة المعلن يجعل المصدر قابلاً للمراجعة ويمنع الانزياح غير المقصود.

يحلل GFM المحتوى السطري داخل الخلايا لكنه لا يسمح بعناصر كتلية فيها. تكون الأنابيب في بداية الصف ونهايته اختيارية في حالات كثيرة، إلا أن إبقاءها يحسن القراءة ويزيل الالتباس. تُستورد صيغ الجداول كنصوص ولا تُحسب، كما تحتاج فواصل CSV داخل الحقول المقتبسة إلى تحليل صحيح قبل التوليد. وتصبح الجداول العريضة صعبة على الهاتف، لذلك قد تكون قائمة قصيرة أو عدة جداول أصغر أوضح من شبكة شاملة واحدة.

استخدم المعاينة المنسقة للتحقق من العناوين ومحاذاة الأعمدة وعلامات | وفواصل الأسطر قبل النسخ أو التنزيل. وانتبه إلى خطأ متكرر: نسيان تهريب علامة | داخل الخلايا مما يكسر الأعمدة.

اختر التحرير المباشر أو استورد CSV أو TSV أو JSON أو جدول Markdown قائماً. صحح الشبكة، وحدد محاذاة كل عمود، وأنشئ المصدر، ثم انسخه أو نزّله بعد أن تتأكد أن المعاينة حافظت على كل خلية مقصودة.

المدخلات: صفوف جدول وخيارات الرأس والمحاذاة وقرارات التنظيف. المخرجات: مصدر جدول GFM مع معاينة مرئية وإجراءات تصدير. تحد الأداة حجم الجدول لسهولة الاستخدام في المتصفح ولا تحول الصيغ إلى حسابات جدول بيانات.

تُحلل البيانات محلياً ولا تُرفع. توحد الشبكة القابلة للتحرير عرض الصفوف وتحافظ على ترتيب البيانات المستوردة وتهرب علامات | وفواصل الأسطر وتنتج علامات المحاذاة مع سجل للتراجع عن التعديلات.