markdown tables gfm reference

Markdown الجداول: دليل كامل على GFM الجدول

كل شيء عن الجداول Markdown الجداول GFM الجملة، وتحديد الأعمدة، الجداول المعقدة، وتقديم الغموض، وكيفية إنشائها من Word المستندات.

W
WordToMD الفريق
·

تسمح لك جداول التخفيض بعرض البيانات المهيكلة في شكل قابل للقراءة والتي تعرض كجدول HTML. يشمل هذا الدليل GFM (GitHub ذو نكهة Markdown)، خيارات المواءمة ، وأنماط متقدمة ، وكيفية تحويل جداول Word إلى Markdown.

الجدول الأساسي

الجدول Markdown يحتوي على ثلاثة أجزاء:

  1. صف الرأس أسماء الأعمدة
  2. صف المفصل المخططات مع الأنابيب، يحدد الجدول
  3. صفوف البيانات المحتوى
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1, Col 1 | Row 1, Col 2 | Row 1, Col 3 |
| Row 2, Col 1 | Row 2, Col 2 | Row 2, Col 3 |

تصنيف مثل:

العمود 1العمود الثانيالعمود 3
الصف الأول، العمود الأولالصف الأول، العمود الثانيالصف الأول، المصفوفة الثالثة
الصف الثاني، العمود الأولالصف الثاني، العمود الثانيالصف الثاني، المصفوفة الثالثة

مواءمة العمود

استخدم المقاطع في الصف الفاصل للتحكم في التواء:

| Left aligned | Center aligned | Right aligned |
|:---|:---:|---:|
| text | text | text |
| longer text | longer text | longer text |
يسار محاذاةمركز محاذاةمُستويات اليمين
texttexttext
نص أطولنص أطولنص أطول
  • :--- المواءمة اليسرى (الجهل)
  • :---: المواءمة المركزية
  • ---: التوجه إلى اليمين

تنسيق داخل خلايا الجدول

معظم التنسيق Markdown في الخط يعمل داخل خلايا الجدول:

| Element | Example |
|---|---|
| Bold | **bold text** |
| Italic | *italic text* |
| Code | `inline code` |
| Link | [click here](https://wordtomd.org) |
| Strikethrough | ~~deleted~~ |

ما لا يعمل: محتوى متعدد الأسطر، قوائم متداخلة، عناصر على مستوى الكتل.

شخصيات الأنابيب في الخلايا

إذا كنت بحاجة إلى أنبوب حرفياً | داخل الزنزانة، هرب منه مع backslash:

| Flag | Description |
|---|---|
| `x \| y` | Bitwise OR operator |

الجداول بدون فترات

المسافة حول الأنابيب اختيارية هذا صحيح:

|Column 1|Column 2|
|---|---|
|Cell|Cell|

لكن المسافات المتسقة تجعل الجداول أكثر قابلية للقراءة. يفضل معظم المحررين والنشرين النموذج المساف.

الخلايا الفارغة

اترك الفراغ بين الأنابيب فارغًا لخلية فارغة:

| A | B | C |
|---|---|---|
| content | | content |
| | content | |

تحويل جدولات Word إلى Markdown

Word الجداول تحويل تلقائيا عندما تستخدم WordToMD. The converter handles:

  • الشبكات القياسية → GFM طاولات الأنابيب
  • عرض الأعمدة → موحد (Markdown لا يسيطر على عرض الأعمدة)
  • تنسيق النص داخل الخلايا → المحفوظة (بالجليد، بالخلفية، بالروابط)

ما الذي لا يحول ؟

  • الخلايا المدمجة (المتوسط/المتوسط) تقع على أقرب خلية
  • محتوى الخلايا متعددة الأسطر انقطاع الأسطر
  • طاولات محشورة طاولة داخلية مسطحة

جدولات التعامل المعقدة Word

الخلايا المدمجة

Words الخلايا المدمجة ليس لديها Markdown مكافئ. خيارات:

  1. إعادة الهيكلة تقسيم الصفوف المدمجة إلى جداول منفصلة
  2. استخدم HTML معظم المعالجات Markdown تقبل HTML الجدول الجدول:
<table>
  <tr>
    <th colspan="2">Merged Header</th>
  </tr>
  <tr>
    <td>Cell 1</td>
    <td>Cell 2</td>
  </tr>
</table>

محتوى الخلية متعددة الأسطر

الاستخدام <br> للانقطاعات داخل الخلايا (يعمل على GitHub ومعظم المنصات):

| Step | Description |
|---|---|
| 1 | Open the file<br>Make sure it's .docx format |
| 2 | Drop it on [WordToMD](/#converter) |

طاولات كبيرة

بالنسبة للجداول التي تحتوي على العديد من الأعمدة، فكر فيما إذا كان الجدول هو الشكل الصحيح. البدائل:

  • قائمة التعريفات (المصطلح + الوصف)
  • الجداول الصغيرة المتعددة حسب الفئة
  • كتلة شفرة للبيانات المنظمة (JSON، YAML)

تقديم الجدول حسب المنصة

المنصةGFM الجداولالمواءمةHTML الجداول
GitHub✅✅✅
غيت لاب✅✅✅
Notion✅❌❌
Obsidian✅✅✅
GitBook✅✅✅
VS عرض مُقدّم للشفرة✅✅✅
Confluence (Markdown ماكرو)✅✅✅
جيكيل / هوغو / أسترو✅✅✅

إمكانية الوصول

لتحسين إمكانية الوصول، تأكد من أن الجداول تحتوي على صف رأس مع أسماء عمود ذات معنى. قراء الشاشة يستخدمون صف الرأس لإعلان سياق الخلية.

| Product | Price | Availability |
|---|---|---|
| Widget A | $9.99 | In stock |
| Widget B | $14.99 | Out of stock |

تجنب استخدام الجداول لأغراض التخطيط استخدمها فقط للبيانات الجدولية الفعلية.

FAQ

لماذا لا يظهر عرض الجدول كنص عادي؟ الصف المفرق (الخط |---|---| (خط) إلزامي. بدونها، لن يتعرف المحلل على هيكل الجدول.

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

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

كيف أخلق جدولًا برمجياً من البيانات؟ المكتبات مثل markdown-table (npm) أو (Pythons) tabulate يمكن توليد جداول Markdown من المصفوفات. هذا مفيد لتحويل الدفعات CSV أو بيانات قاعدة البيانات.

النتيجة

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