Markdown الجداول: أنشئها بدلاً من عد الأنابيب

بناء الجملة، في مثال واحد

                | Tool          | Input       | Offline |
| :------------ | :---------: | ------: |
| YAML to JSON  | YAML        | yes     |
| JWT decoder   | JWT         | yes     |
              

الصف الأول هو الرأس، والثاني هو الصف المحدد، وكل شيء بعده هو البيانات. تقوم النقطتان في صف المحدد بالمحاذاة: `:---` يسار، `:---:` مركز، `---:` يمين. يقبل GitHub ومعظم العارضين الأنابيب البادئة واللاحقة كاختيارية، ولكن تضمينها يجعل النص الخام قابلاً للقراءة في المحرر.

الأشياء الثلاثة التي تكسر الجداول

• أنبوب داخل خلية - قم بالخروج منه كـ `\|`، أو تم تقسيم الصف إلى عمود واحد أكثر من اللازم.
• صف محدد يحتوي على عدد غير صحيح من الأعمدة - يتغير الرأس ويتم عرض الجدول بشكل غير صحيح.
• سطر فارغ داخل الجدول - يعامله العارض على أنه نهاية الجدول ويطبع الباقي كنص.

يعتبر الهروب أمرًا بالغ الأهمية بالنسبة للتعليمات البرمجية والتعبيرات المنطقية في الخلايا: يحتاج كل من `a|b` و `\bfoo\b` إلى الاهتمام قبل أن يتمكنا من العيش بسعادة داخل الطاولة.

الحصول على البيانات من جدول البيانات

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

عندما لا تستخدم الجدول

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

إنشاء، ثم لصق في أي مكان

الإخراج عبارة عن تخفيض بسيط، لذلك يتم إسقاطه مباشرة في ملف README أو وصف طلب السحب أو صفحة wiki أو تذكرة Jira أو تعليق. يعمل منشئ جدول تخفيض السعر YamlBox في المتصفح، ويقوم بمحاذاة الأعمدة لك، ويتجنب الأنابيب، ويستمر في العمل دون اتصال - حتى تتمكن من لصق البيانات الداخلية دون نشرها في أي مكان.