لعرض عدة أسطر داخل خلية واحدة في جدول Markdown، أبقِ الصف في سطر واحد في المصدر وأدرج <br> بين العبارات. يعمل هذا في المواضع التي تدعم الجداول وHTML المضمّن؛ تحقّق من Obsidian ومن العارض الذي تستخدمه قبل الاعتماد عليه.

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

ما عارضات Markdown التي تدعم خلايا الجداول متعددة الأسطر؟

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

توثّق Obsidian الجداول ذات الأنابيب والتنسيق داخل الخلايا. كما تحدد وثائق الصياغة الأساسية فيها <br> على أنه وسم لكسر السطر. ويشكّل هذان الأمران أساسًا موثقًا للطريقة المستخدمة هنا، مع أن صفحة الجداول لا تقدم مثالًا مخصصًا لخلية متعددة الأسطر. راجع صياغة التنسيق المتقدمة وصياغة التنسيق الأساسية.

استخدم جدول القرار هذا قبل تحرير مستند كبير:

الوجهة الحدود الموثقة الخيار العملي
CommonMark الأساسي من دون امتدادات الجداول ذات الأنابيب خارج الصياغة الأساسية استخدم العناوين والقوائم
عارض متوافق مع GFM تقبل الجداول محتوى مضمّنًا، من دون عناصر كتلية داخل الخلايا جرّب فاصلًا مضمّنًا وتحقّق من الوجهة
Obsidian الجداول ووسم كسر السطر موثّقان حرّر المصدر، ثم افحص عرض القراءة
عارض لا يُعرف سلوكه مع HTML لم يُتحقق من دعمه نفّذ المقارنة الصغيرة أدناه قبل اختيار تنسيق

تستند الصفوف الثلاثة الأولى إلى مواصفات CommonMark ومواصفات GFM ووثائق Obsidian المرتبطة أعلاه. أما الصف الأخير فهو خطوة تحقق موصى بها: اسم العارض وحده لا يحدد طريقة تعامله مع مستندك.

كيف تكتب سطرين داخل خلية واحدة؟

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

| Item | Details |
| --- | --- |
| Notebook | Dotted pages<br>Blue cover |
| Pencil | Graphite core<br>Hexagonal shape |

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

تجمع هذه الآلية بين كسر سطر من HTML مضمّن وصياغة الجداول. توثّق GitHub وسم كسر السطر في عداد الطرق المدعومة لإنشاء فواصل الأسطر، بينما توثّق Obsidian <br> صراحةً. هذه خلايا Markdown تستعين بـHTML، لذا يعتمد مدى توافقها بين الوجهات على قبول الوجهة لهذه العلامات. راجع وثائق GitHub حول فواصل الأسطر ووثائق Obsidian حول الصياغة الأساسية.

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

لماذا لا يحل الضغط على Enter أو استخدام مسافتين أو شرطة مائلة عكسية المشكلة؟

يدعم CommonMark فواصل الأسطر الصلبة باستخدام مسافتين في نهاية السطر أو شرطة مائلة عكسية قبل سطر جديد في المصدر. تتعلق هذه القواعد بالمحتوى المضمّن داخل كتلة موجودة؛ ولا تحدد خلايا جداول الأنابيب متعددة الأسطر. راجع فواصل الأسطر الصلبة في CommonMark.

على سبيل المثال، هذا غير مناسب عمدًا لإبقاء العبارتين داخل خلية GFM واحدة:

| Item | Details |
| --- | --- |
| Notebook | Dotted pages
Blue cover |

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

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

كيف تتحقق من الجدول في Obsidian على Mac؟

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

  1. بدّل الملاحظة إلى وضع المصدر باستخدام عنصر التحكم الخاص بوضع التحرير في شريط الحالة. يعرض هذا الوضع Markdown كما كُتب تمامًا.
  2. ألصق العينة وتأكد من بقاء كل صف بيانات في سطر واحد في المصدر.
  3. اضغط Cmd+E للتبديل بين التحرير وعرض القراءة.
  4. افحص خليتي التفاصيل: ينبغي أن تحتوي كل منهما على سطرين معروضين، وألا تنتقل أي عبارة إلى صف جديد في الجدول.
  5. عُد إلى التحرير وقارن النتيجة أيضًا في المعاينة المباشرة.

توثّق Obsidian وضع المصدر والمعاينة المباشرة والاختصار على Mac في أوضاع العرض والتحرير. تخفي المعاينة المباشرة قدرًا كبيرًا من الصياغة أثناء التحرير؛ ويوفر عرض القراءة فحصًا منفصلًا مفيدًا للملاحظة المنسقة.

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

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

كيف تشخّص اختلافات العارضات بسرعة؟

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

Control:

| Item | Details |
| --- | --- |
| Notebook | Dotted pages; blue cover |

Multiline candidate:

| Item | Details |
| --- | --- |
| Notebook | Dotted pages<br>Blue cover |

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

استخدم هذه الملاحظات لتحديد ما ينبغي فحصه بعد ذلك:

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

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

ماذا تستخدم عندما لا تكون الخلايا متعددة الأسطر مدعومة؟

إذا كانت الوجهة تقبل الجداول لكنها ترفض HTML المضمّن، فاستخدم صفًا لكل تفصيل. يحافظ تكرار اسم العنصر على الارتباط من دون الحاجة إلى فاصل داخل الخلية:

| Item | Detail |
| --- | --- |
| Notebook | Dotted pages |
| Notebook | Blue cover |

إذا كانت الوجهة لا تدعم إلا CommonMark الأساسي، فانقل التفاصيل إلى عنوان وقائمة:

### Notebook

- Dotted pages
- Blue cover

تنتمي العناوين والقوائم إلى صياغة CommonMark. كما يتيح هذا البديل مساحة أكبر للعناصر الطويلة، من دون الاعتماد على امتداد الجداول.

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

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

المصادر