لإبقاء مصدر جدول Markdown مقروءًا، أضف مسافات حول الخلايا وأعِد محاذاة كل عمود بعد التعديلات المطوّلة. عند استخدام Obsidian على جهاز Mac، أجرِ التعديلات في محرر الجداول الأصلي، ثم تفحّص وضع المصدر. يلزم التحقق من المسافات في المصدر ومن محاذاة النص المعروض كلٌّ على حدة.

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

ما الذي يجعل مصدر جدول Markdown مقروءًا؟

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

على سبيل المثال، هذا الجدول الاصطناعي موجز، لكن يصبح تصفّحه أصعب بعد إدخال اسم عنصر أطول:

| Item | Finish | Count |
| --- | --- | ---: |
| Pencil | Matte | 4 |
| Large sketchbook | Linen | 12 |

تجعل إضافة المسافات المحتوى نفسه أسهل للفحص كنص عادي:

| Item             | Finish | Count |
| ---------------- | ------ | ----: |
| Pencil           | Matte  |     4 |
| Large sketchbook | Linen  |    12 |

في GFM، تُحذف المسافات بين حدود الأنبوب ومحتوى الخلية. لذلك لا تحدد المسافات المضافة عرضًا للعمود المعروض. تتحكم النقطتان في ----: بمحاذاة العمود المعروض إلى اليمين؛ أما المسافات قبل 4 فالغرض منها ببساطة تسهيل تصفّح مثال المصدر هذا. مواصفات GitHub Flavored Markdown، الجداول.

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

أي عارض سيقرأ الجدول؟

جداول الأنابيب امتداد وليست ميزة في CommonMark الأساسي. الإصدار الحالي من مواصفات CommonMark هو 0.31.2، بينما تحدد مواصفات GFM المنشورة من GitHub الجداول صراحةً بوصفها امتدادًا لـ CommonMark. العارض الموصوف بأنه متوافق مع CommonMark فقط لا يضمن بذلك دعم جداول الأنابيب. تحقّق مما إذا كان يدعم أيضًا امتداد الجداول. مواصفات CommonMark، مواصفات GitHub Flavored Markdown.

تكتسب الفروقات التالية أهمية عند نقل ملاحظة بين التطبيقات:

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

تستند متطلبات الشرطات أعلاه إلى أدلة المنتجات المعنية. واستخدام ثلاث شرطات على الأقل قاعدة مشتركة ملائمة لهاتين الوجهتين؛ لكنه لا يجعل جميع عوارض Markdown متكافئة. توثيق جداول GitHub، صيغة Obsidian المتقدمة.

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

كيفية الحفاظ على محاذاة الجدول في Obsidian على جهاز Mac

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

اتبع هذه الخطوات في ملاحظة عادية:

  1. افتح الملاحظة في Live Preview. إذا لزم الأمر، اختر هذا الوضع من أيقونة الحالة في المحرر.
  2. أدرج جدولًا باستخدام الأمر Insert Table، أو انقر بزر الفأرة الأيمن واختر Insert → Table.
  3. أدخل محتوى الخلايا أو عدّله في محرر الجداول. انقر بزر الفأرة الأيمن على الجدول لإضافة الصفوف والأعمدة أو حذفها أو نقلها أو فرزها.
  4. اختر Source mode من أيقونة الحالة، ثم تفحّص Markdown الناتج.
  5. انتقل إلى Reading view للتحقق من الجدول المعروض.

ترد أوضاع العرض في العرض ووضع التحرير، بينما توثّق صيغة التنسيق المتقدمة إدراج الجداول واستخدام قائمة السياق.

للتبديل المتكرر، عيّن مفتاح اختصار للأمر Toggle Live Preview/Source mode. في macOS، يبدّل Cmd+E بين وضعي القراءة والتحرير؛ استخدم أمر الوضع المخصص عندما يكون هدفك تحديدًا التبديل بين وضعي التحرير. العرض ووضع التحرير في Obsidian.

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

كيفية إعادة محاذاة أعمدة المصدر بعد تعديل مطوّل

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

إليك مثالًا عمليًا باستخدام نص ASCII عادي فقط. ابدأ بهذا الجدول:

| Item   | Finish | Count |
| ------ | ------ | ----: |
| Pencil | Matte  |     4 |
| Folder | Linen  |    12 |

استبدل الآن Folder بـ Large sketchbook. يتكون المدخل الجديد من 16 محرفًا، لذا يحتاج العمود الأول إلى مساحة محتوى بعرض 16 محرفًا. اترك مسافة واحدة مباشرةً داخل كل حدّ من حدود الأنبوب، ثم أضف ما يكفي من المسافات اللاحقة لملء تلك المساحة:

  • يتكون Item من 4 محارف، لذا أضف بعده 12 مسافة حشو، ثم مسافة الحدّ.
  • يتكون Pencil من 6 محارف، لذا أضف بعده 10 مسافات حشو، ثم مسافة الحدّ.
  • يملأ Large sketchbook المساحة ذات الـ 16 محرفًا، لذا لا يحتاج إلا إلى مسافة الحدّ بعده.
  • مدّد خلية الفاصل الأولى إلى 16 شرطة لتكون دليلًا بصريًا مطابقًا.

والنتيجة هي الجدول المحشو المعروض سابقًا. لم يحتج سوى العمود الأول إلى التوسيع. أما الأعمدة الأخرى فاحتفظت بمسافاتها وعلامات محاذاتها.

هذه طريقة تنسيق يدوية للمثال المحدد المكتوب بـ ASCII، وليست خوارزمية عامة لقياس عرض المحارف. في التحرير اليومي، تفحّص النتيجة في عرض مصدر بخط أحادي المسافة. إذا احتوت الخلايا على تنسيق مضمّن كثير، فقيّم عرض المصدر استنادًا إلى المحارف المكتوبة فعليًا، بما فيها علامات الترقيم مثل العلامتين الخلفيتين والنجمتين.

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

ما الذي ينبغي التحقق منه عندما يتعطل الجدول؟

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

اتبع خطوات التشخيص هذه بعد تعديل كبير:

  1. قارن صف الرأس بصف الفواصل. أنشئ خلية فاصلة مقابلة لكل عنوان.
  2. افحص كل صف من صفوف المحتوى. أبقِ العدد المقصود من الخلايا حتى عندما تكون إحدى القيم فارغة.
  3. ابحث عن علامات الأنبوب الحرفية في المحتوى. قد تُفسّر علامة أنبوب غير مهروبة على أنها حدّ آخر.
  4. افحص حدود الصفوف. اجعل كل صف من صفوف الجدول في سطر مصدر واحد، وتجنب الأسطر الفارغة داخل الجدول.
  5. عاين الوجهة. تحقق من القيم المعروضة ومظهر الجدول.

توثّق GitHub وضع شرطة مائلة عكسية قبل علامة الأنبوب الحرفية. يحافظ هذا المثال الكامل على Blue | Green داخل خلية واحدة:

| Item   | Options       |
| ------ | ------------- |
| Folder | Blue \| Green |

هذا الهروب يعالج البنية؛ وإضافة مزيد من المسافات حول علامة أنبوب غير مهروبة لن تصلح المشكلة. مثال GitHub لعلامة الأنبوب الحرفية.

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

لا تضغط Enter في منتصف خلية طويلة لجعل مصدرها يبدو أضيق. تقبل جداول GFM محتوى مضمّنًا وتستبعد العناصر على مستوى الكتل؛ وهي لا توفر صيغة عامة لخلايا المصدر متعددة الأسطر. انقل الشروح الطويلة إلى خارج الجدول عندما يصبح إبقاء الصفوف في سطر واحد غير عملي. قواعد محتوى جداول GFM.

اجعل روتين الصيانة بسيطًا: أكمل تعديلات المحتوى، وافحص حدود الخلايا، وأضف المسافات إلى الأعمدة المتأثرة، ثم راجع الجدول المعروض. في Obsidian، يُعد محرر الجداول الأصلي متبوعًا بـ Source mode نقطة انطلاق عملية. وتظل إضافة المسافات يدويًا مفيدة عندما تريد تخطيطًا معينًا للنص العادي.

المصادر