مولّد جداول Markdown

جداول Markdown دقيقة للغاية: يكفي غياب علامة شريطة عمودية واحدة أو صف فاصل غير مستوٍ حتى يتحوّل الجدول بأكمله إلى نص عادي. يوفّر هذا المولّد شبكة مرئية تكتب فيها، ويتيح لصق ملفات CSV أو TSV من جدول بيانات، ويُنتج جدول Markdown مُعبّأ تتحاذى فيه الأعمدة داخل المصدر، أسهل بكثير في القراءة عند المقارنة (diff) وفي تصحيحه من المحاولة الأولى.

كيفية إنشاء جدول Markdown

  1. 1

    اختر الصفوف والأعمدة

    أو الصق ملف CSV أو TSV، وستستنتج الأداة الأبعاد تلقائيًا.

  2. 2

    اكتب محتوى الخلايا

    انقر داخل كل خلية. مفتاح Tab ومفاتيح الأسهم تتنقّل كما في جدول البيانات.

  3. 3

    اضبط محاذاة الأعمدة

    يسار (الافتراضي)، أو توسيط، أو يمين لكل عمود عبر صف العناوين.

  4. 4

    انسخ ناتج Markdown

    تملأ الأداة الشرطات العمودية حتى عرض العمود، فيبدو المصدر نظيفًا.

صيغة جداول Markdown

جدول أساسي:

| عمود أ  | عمود ب  | عمود ج  |
|---------|---------|---------|
| خلية 1  | خلية 2  | خلية 3  |
| خلية 4  | خلية 5  | خلية 6  |

تُحدَّد المحاذاة بالنقطتين الرأسيتين (:) في صف الفصل:

| يسار | توسيط | يمين |
|:-----|:-----:|-----:|
| a    | b     | c    |
  • :--- محاذاة لليسار
  • :---: توسيط
  • ---: محاذاة لليمين

ما الذي يفعله المولّد نيابةً عنك

  • يملأ كل خلية حتى عرض أطول قيمة في عمودها، فتتحاذى الشرطات العمودية في المصدر. لا يؤثّر ذلك على الناتج المعروض، إذ يتجاهل Markdown المسافات الزائدة، لكن من يقرأ المقارنة (diff) سيشكرك على ذلك.
  • يحوّل الشرطات العمودية داخل الخلايا إلى \|، فلا تنقسم الخلية التي تحتوي على a|b إلى عمودين.
  • يحافظ على المحاذاة عند تغيير عرض الأعمدة.
  • يقبل لصق CSV وTSV؛ ويكتشف الحقول المُحاطة بعلامات اقتباس والفواصل داخل علامات الاقتباس.

الأخطاء الشائعة

  • صف الفاصل إلزامي. تُعرض جداول Markdown التي تفتقر إلى سطر |---|---| كنص عادي.
  • لا توجد خلايا متعددة الأسطر. كل صف سطر واحد؛ أدرِج <br> عند الحاجة إلى فاصل داخلي، لأن فواصل الأسطر في Markdown داخل خلايا الجدول غير مدعومة.
  • لا توجد جداول متداخلة. إذا احتجت إليها، فاستخدم HTML.
  • الخلايا الفارغة تحتاج إلى مسافة (أو على الأقل زوج من الشرطات العمودية الفارغة). تجنّب استخدام || مباشرةً.

متى تستخدم HTML بدلاً من ذلك

إذا كنت بحاجة إلى colspan أو rowspan أو خلايا متعددة الأسطر أو فئات CSS مخصّصة، فإن جداول HTML هي الأداة المناسبة. ومعظم محلّلات Markdown تقبل ترميز جداول HTML الخام مباشرةً داخل النص.

أين تعمل جداول Markdown جيدًا

  • ملفات README على GitHub وGitLab وGitea.
  • أوصاف المشكلات (issues) وطلبات السحب (PR).
  • Obsidian وBear ومعظم تطبيقات تدوين الملاحظات.
  • Docusaurus وMkDocs وHugo، جميعها تدعم جداول GFM.

الأسئلة الشائعة

ليس بشكل أصلي؛ استخدم <br> لفاصل السطر المضمّن. وللمحتوى متعدد الأسطر الحقيقي (كتل التعليمات البرمجية أو القوائم داخل خلية)، اعتمد بدلاً من ذلك على <table> في HTML.

لا يدعم GFM دمج الخلايا. إذا كنت بحاجة إلى colspan أو rowspan، فاستخدم HTML داخل مستند Markdown؛ إذ تمرّر معظم برامج العرض وسم <table> دون تعديل.

لا. يظل HTML المعروض متطابقًا سواء أضفت تعبئة أم لا؛ فالتعبئة مجرد خيار يتعلق بسهولة قراءة المصدر.

نعم. عند النسخ من جدول بيانات، توضَع البيانات في الحافظة بصيغة TSV (قيم مفصولة بعلامات جدولة). يكتشف المولّد صيغة TSV ويبني جدول Markdown بالصفوف والأعمدة نفسها.

اكتب \|؛ فمعظم المحلّلات تعرض حينئذٍ شرطة عمودية حرفية دون كسر حدود العمود.

أدوات ذات صلة

الأداة متاحة بلغات أخرى