Markdown هو التنسيق الذي أكتب به كل شيء تقريبًا - READMEs، ووثائق المكونات الإضافية، وملاحظات الإصدار، وأوصاف طلب السحب، وسجل التغيير لـ WP Adminify، ونصف ملاحظاتي الداخلية. إنه يبتعد عن كل بناء باستثناء واحد. في اللحظة التي يتم فيها تضمين الجدول، أتوقف عن الكتابة وأبدأ في عد أحرف الأنابيب، ويختفي التدفق. أضف عمودًا إلى جدول مكون من خمسة صفوف وستقوم بتحرير ستة أسطر يدويًا، بالإضافة إلى صف المحدد، ولن تعرف ما إذا كنت قد قمت بتحريره بشكل صحيح حتى يتم عرض الصفحة.
ليرة تركية؛DR: ال مولد الجدول يمنحك شبكة على شكل جدول بيانات، وينشئ GitHub Flavored Markdown صالحًا أثناء الكتابة، ويستورد CSV أو لصق جدول البيانات أو جدول Markdown موجود حتى تتمكن من إعادة هيكلته. قم بتعيين محاذاة لكل عمود بنقرة واحدة، وقم بتصدير Markdown أو HTML أو CSV. كل شيء يعمل في متصفحك.
توجد الأداة لأن بناء جملة الجدول هو الجزء الوحيد من Markdown حيث يحارب التنسيق المصدر التحرير بشكل نشط. يغطي هذا الدليل كيفية عمل جداول GFM، والقواعد التي تحدد ما إذا كانت جداول العرض الخاصة بك، ومصائد الهروب التي تكسر الصفوف، وكيفية استخدام المولد لجداول سير العمل التي تأتي عادةً من - جدول بيانات، أو نتيجة استعلام، أو جدول كتبه شخص ما بالفعل.
ما هو جدول Markdown؟
جدول Markdown عبارة عن ثلاثة مكونات مكدسة بترتيب ثابت: صف الرأس، وصف المحدد، وصفر أو أكثر من صفوف الجسم. الجداول ليست جزءًا من Markdown الأساسي على الإطلاق - فهي امتداد محدد بواسطة مواصفات GitHub المنكهة Markdown، ولهذا السبب يمكن عرض الجدول على GitHub والخروج كأنابيب حرفية في مكان آخر. يتم فصل الخلايا بأحرف الأنابيب، ويشغل كل صف سطرًا واحدًا بالضبط.
| Tool | Category | Offline |
| --- | --- | --- |
| JSON Formatter | Coding | Yes |
| YAML to JSON | Data | Yes |
صف المحدد هو الجزء الذي يجعله جدولًا وليس فقرة تحتوي على أنابيب. يجب أن يكون السطر الثاني، ويجب أن يتكون من واصلات ذات كولونات اختيارية، ويجب أن يحتوي على نفس عدد الخلايا الموجودة في الرأس. احصل على أي من هذه الأخطاء ويعامل العارض الكتلة بأكملها كنص عادي - ولهذا السبب "؛ يتم عرض طاولتي كنص عادي وquot؛ هي دائمًا مشكلة صف محدد.
الجداول ليست جزءًا من مواصفات CommonMark الأصلية. لقد وصلت كملحق GitHub Flavored Markdown وتم اعتمادها لاحقًا في كل مكان تقريبًا: GitHub، وGitLab، وBitbucket، وObsidian، وNotion، وDocusaurus، وMkDocs، وVitePress، وHugo، وJekyll، وDiscord، ومعظم مولدات المواقع الثابتة. "؛ تقريبا واقتباس؛ هي الكلمة التشغيلية. سيُظهر عارض CommonMark البسيط بدون امتدادات جدولك كأنابيب حرفية، والإصلاح هو إصدار HTML بدلاً من ذلك - وهو ما يمكن للمولد القيام به بنقرة واحدة على علامات تبويب الإخراج.
لماذا يصعب الحفاظ على بناء الجملة مما يبدو
من السهل قراءة جدول تخفيض السعر. الحفاظ على واحد هو المكان الذي تختبئ فيه التكلفة، ويأتي من أربعة أماكن.
الهيكل يعيش في علامات الترقيم. لا توجد حدود للخلية باستثناء الحرف الذي يظهر أيضًا في التعبيرات العادية وأوامر الصدفة وأنواع اتحاد TypeScript. يجب الهروب من كل واحد من الموجودين داخل الخلية أو يكتسب الصف عمودًا بصمت.
يتم ترميز المحاذاة في موضع القولون. النقطتين الموجودتين على اليسار تعني محاذاة إلى اليسار، والنقطتين على كلا الجانبين تعني المنتصف، والنقطتين الموجودتين على اليمين تعني محاذاة إلى اليمين. لا توجد كلمة رئيسية لتذكرها بها، والفرق بينهما ---: و :--- هي شخصية واحدة على التوالي لا أحد يقرأها عن كثب.
التحرير متعدد الأسطر. إضافة عمود يعني لمس كل صف بالإضافة إلى المحدد. إعادة ترتيب الصفوف تعني القص واللصق دون أي ردود فعل مرئية. حذف عمود هو البحث عن الأنبوب n في كل سطر.
محاذاة المصدر يدوية. الأعمدة المبطنة ليست مطلوبة - يتجاهل العارضون مسافات إضافية - ولكن قراءة الجداول غير المبطنة تكون بائسة في فرق، لذلك يقوم الأشخاص بوضعها يدويًا ثم إعادة وضعها في كل مرة ينمو فيها محتوى الخلية '؛s.
يقوم محرر الشبكة بإزالة الأربعة. تقوم بتحرير الخلايا؛ يتم إنشاء بناء الجملة. هذه هي الفرضية الكاملة للأداة.
كيفية استخدام مولد جدول Markdown
الخطوة 1: أدخل بياناتك إلى الشبكة
ثلاثة مسارات، اعتمادًا على المكان الذي تعيش فيه البيانات بالفعل.
اكتبها. تفتح الشبكة بعينة مملوءة. قم بالكتابة فوق الخلايا، أو اضغط على Clear للحصول على صورة فارغة ثلاثة في ثلاثة وابدأ من جديد.
لصق من جدول البيانات. افتح لوحة الاستيراد والصق نطاقًا منسوخًا من Excel أو Google Sheets أو Numbers أو LibreOffice. تضع جداول البيانات نصًا مفصولًا بعلامات تبويب على الحافظة، ويكتشف المستورد ذلك تلقائيًا - ولا داعي لإخباره بالمحدد الذي تستخدمه.
لصق CSV أو جدول موجود. تقبل نفس اللوحة CSV، والصادرات المفصولة بفاصلة منقوطة (الافتراضي في العديد من اللغات الأوروبية)، والنص المحدد بالأنبوب، وجداول Markdown. إذا كان النص يشبه جدول Markdown - سطر رأس متبوعًا بصف محدد - فسيتم تحليله كجدول واحد، بما في ذلك محاذاة الأعمدة، حتى تتمكن من تحميل جدول من README وإعادة هيكلته ولصقه مرة أخرى.
يتبع استيراد CSV قواعد RFC 4180 بدلاً من التقسيم على الفواصل بسذاجة. يمكن أن يحتوي الحقل المقتبس على فواصل وفواصل أسطر وعلامات اقتباس مضاعفة تمثل حرف اقتباس حرفي. وهذا يهم أكثر مما يبدو: أي تصدير يحتوي على عنوان أو وصف أو سعر في لغة تستخدم الفواصل سوف يكسر تقسيمًا ساذجًا، ولن تلاحظ ذلك حتى يصبح العمود قصيرًا بخلية واحدة. إذا كان ملف CSV الخاص بك كبيرًا بما يكفي بحيث تريد فحصه قبل الاستيراد، فإن عارض CSV يفتحه في شبكة قابلة للفرز أولاً.
الخطوة 2: تشكيل الجدول
تغطي عناصر التحكم حول الشبكة العمليات المؤلمة في Markdown الخام
- صف و عمود أضف إلى نهاية الشبكة.
- الأسهم الموجودة بجانب كل صف تحركه لأعلى أو لأسفل - وهو أمر مفيد لطلب جدول المقارنة حسب ما قررته أكثر من غيره.
- يقوم زر الطرح الموجود على رأس الصف أو العمود بحذفه عبر كل صف مرة واحدة.
- تبديل تبديل الصفوف والأعمدة. غالبًا ما يتم توجيه البيانات الملصقة من التقرير بطريقة خاطئة للمستند، ويتم النقل بنقرة واحدة بدلاً من إعادة الكتابة الكاملة.
الخطوة 3: ضبط المحاذاة لكل عمود
يحمل كل رأس عمود ثلاثة أزرار محاذاة: اليسار والوسط واليمين. انقر فوق واحد لتطبيقه، ثم انقر عليه مرة أخرى للعودة إلى العارض '؛s الافتراضي. يكتب المولد النقطتين المقابلتين في صف المحدد.
المحاذاة تستحق الاستخدام عمدا. الأعمدة الرقمية - الأسعار، والأعداد، والنسب المئوية، والمدد - تقرأ بشكل أفضل بكثير بمحاذاة اليمين، لأن الأرقام تصطف حسب القيمة المكانية. تبدو قيم الحالة القصيرة مرتبة في المنتصف. النص ينتمي إلى اليسار. هذه ليست زخرفة؛ يعد عمود الأرقام المحاذي لليمين أسرع حقًا في البحث عن القيمة الأكبر.
الخطوة 4: اختر تنسيق الإخراج وانسخه
ثلاث علامات تبويب الإخراج:
تخفيض السعر تنتج جي اف ام. ال أعمدة مبطنة يتحكم التبديل فيما إذا كانت الخلايا مبطنة بمسافات بحيث يصطف المصدر الأولي في محرر أحادي المسافة. لا يغير الحشو شيئًا بشأن كيفية عرض الجدول - فهو مخصص فقط لمن يقرأ الملف في فرق. الأنابيب الخارجية يتحكم في الأنبوب الأمامي والخلفي في كل صف؛ كلا الأسلوبين صالحان، ونمط الأنبوب الأمامي هو التقليد الأكثر شيوعًا إلى حد بعيد.
HTML ينتج أ <table> مع <thead> و <tbody> ومضمنة text-align الأنماط المطابقة لمحاذاة الأعمدة الخاصة بك. استخدمه للعارضين الذين يفتقرون إلى دعم الجدول، أو لقوالب البريد الإلكتروني، أو عند الحاجة colspan والخلايا متعددة الأسطر التي لا يستطيع Markdown التعبير عنها. إذا كنت تريد الذهاب في الاتجاه الآخر ورفع جدول من صفحة الويب، HTML إلى Markdown يتعامل معها.
CSV يعطيك الشبكة مرة أخرى كبيانات، مقتبسة بشكل صحيح، للصقها في جدول بيانات أو تغذيتها إلى برنامج نصي.
انسخ إلى الحافظة أو قم بتنزيلها كـ .md، .html، أو .csv ملف.
قواعد الهروب التي تكسر الجداول بالفعل
يتسبب حرفان في كل جدول Markdown معطل تقريبًا، ويتم التعامل مع كليهما تلقائيًا بواسطة المولد - ولكن يجب أن تعرف قواعد الجداول التي تقوم بتحريرها يدويًا.
الأنبوب. يجب كتابة الأنبوب الحرفي داخل الخلية كـ \|. بدون الشرطة المائلة العكسية، يرى العارض فاصل عمود ويكتسب صفك خلية، ويتخلص من كل عمود بعده. وهذا يعض بشدة في الوثائق الفنية، حيث تحتوي الخلايا بشكل شرعي على أشياء مثل string | null، grep foo | wc -l، أو تناوب regex. يعمل الهروب حتى داخل امتدادات رمز التراجع - وهي حالة نادرة حيث يكون Markdown'؛s المعتاد "؛ امتدادات التعليمات البرمجية حرفية وحاسمة؛ القاعدة لا تنطبق.
الخط الجديد. تتكون جداول GFM من صف واحد لكل سطر، لذلك لا يمكن أن تحتوي الخلية على فاصل سطر حقيقي. الحل العالمي هو HTML <br> علامة. عند لصق محتوى متعدد الأسطر في الشبكة، يقوم المولد بإدراج العلامة لك؛ عند استيراد جدول يحتوي على <br>، يتحول مرة أخرى إلى فاصل سطر حقيقي في المحرر بحيث تكون الخلية مريحة للتحرير.
هناك قاعدتان أخريان تستحقان الالتزام بالذاكرة لأنهما تسببان "؛ طاولتي لا تعرض وتقتبس؛ التقارير التي لا علاقة لها بالجدول نفسه. أولاً، يحتاج الجدول إلى سطر فارغ قبله عندما يتبع فقرة. ثانيًا، داخل عنصر القائمة، يجب وضع مسافة بادئة للجدول بأكمله في عمود محتوى عنصر القائمة '؛ - وإلا فإن القائمة تبتلع السطر الأول ويهبط صف المحدد في المكان الخطأ.
من أين تأتي الجداول، وكيف تتدفق كل حالة
جدول بيانات تم إرسالك إليه
انسخ النطاق، والصقه في لوحة الاستيراد، وقم بتحميله في الشبكة، وحذف الأعمدة التي لا يحتاجها أحد، وقم بمحاذاة العمود الرقمي إلى اليمين، وانسخ Markdown. أقل من دقيقة لجدول قد يستغرق تنسيقه يدويًا عشرة.
نتيجة استعلام أو استجابة API
البيانات التي تبدأ كـ JSON تحتاج عادةً إلى قفزة واحدة. تحويله مع json إلى CSV، ثم لصق ملف CSV في المستورد. بالذهاب في الاتجاه الآخر - جدول Markdown الذي تحتاجه كبيانات - تصدير ملف CSV من علامات تبويب الإخراج وتشغيله من خلاله CSV إلى JSON.
جدول موجود بالفعل في README
الصقها في لوحة الاستيراد. يعود إلى الشبكة مع محاذاة سليمة، لذا فإن إضافة عمود أو إعادة ترتيب الصفوف يعد تحريرًا عاديًا وليس إعادة كتابة. هذا هو سير العمل الذي أستخدمه أكثر من غيره: تنمو جداول الوثائق صفًا واحدًا في كل مرة لعدة أشهر، ثم تحتاج إلى إعادة الهيكلة مرة واحدة.
جدول المقارنة الذي تكتبه من الصفر
ابدأ بالشبكة، واكتب كما تعتقد، واترك الحشو يفرز نفسه. إن كتابة مقارنة في شبكة بدلاً من بناء جملة الأنابيب يبقي انتباهك على ما إذا كانت المقارنة عادلة بدلاً من التركيز على ما إذا كانت الأعمدة تصطف أم لا.
التوثيق الذي يجب أن يعمل في العديد من العارضين
قم بإنشاء Markdown للأنظمة الأساسية التي تدعم جداول GFM، ثم قم بتبديل علامة التبويب الإخراج إلى HTML للنظام الذي لا يدعمها. نفس الشبكة، تصديران، لا إعادة كتابة. إذا قام خط الأنابيب الخاص بك بتحويل Markdown إلى HTML على أي حال، Markdown إلى HTML يوضح لك بالضبط ما ينتجه التحويل.
جداول Markdown مقابل جداول HTML
| اعتبار | جدول تخفيض السعر | جدول HTML |
|---|---|---|
| سهولة قراءة المصدر | عالية - قابلة للمسح الضوئي كنص عادي | العلامات المنخفضة تهيمن على المحتوى |
| خلايا متعددة الخطوط | فقط عبر <br> |
أصلي، أي محتوى كتلة |
| الخلايا المدمجة | غير مدعوم | colspan و rowspan |
| محاذاة لكل عمود | نعم، عبر القولون المحدد | نعم، عبر CSS أو السمات |
| التحكم في التصميم | لا أحد | Css كامل |
| دعم العارض | امتداد GFM، واسع الانتشار ولكنه ليس عالميًا | عالمي حيثما يُسمح بـ HTML |
| الصداقة المختلفة | جيد، سطر واحد في كل صف | ضعيف، عدة أسطر في الصف الواحد |
القاعدة العملية: استخدم Markdown حتى تحتاج إلى خلية مدمجة، أو عنصر كتلة داخل خلية، أو تصميم محدد. ثم قم بتبديل هذا الجدول إلى HTML واترك بقية المستند بمفرده. يقوم معظم عارضي Markdown بتمرير HTML الخام، لذا فإن خلط الاثنين في ملف واحد أمر طبيعي.
ملاحظة حول الخصوصية
غالبًا ما تكون الجداول التي ينشئها الأشخاص هي التي يفضلون عدم تحميلها: لم يتم الإعلان عن الأسعار بعد، وعدد الموظفين، والمعايير الداخلية، والعميل '؛ البيانات الملصقة من جدول البيانات.
المولد هو جافا سكريبت من جانب العميل. الشبكة ومحلل الاستيراد وكل عملية تصدير في الصفحة، ولا يترك أي شيء تقوم بلصقه جهازك. قم بتحميله مرة واحدة وسيستمر في العمل دون اتصال بالإنترنت. هذا هو نفس المبدأ وراء كل شيء على Toolz.dev، والتفكير يستحق القراءة بالكامل في الدليل الخاص به خصوصية البيانات في الأدوات عبر الإنترنت. إذا كنت تقوم بتجميع مجموعة أوسع من الأدوات المساعدة المستندة إلى المتصفح للعمل اليومي، فإن دليل أدوات الترميز و ال مجموعة أدوات مطور الويب قم بتغطية ما يكسب إشارة مرجعية أيضًا.
نصائح عملية
إبقاء الرأس قصيرة. مع الحشو، تقوم الخلية الأوسع في العمود بتعيين عرض كل صف في المصدر. رأس مطول يجعل الملف الخام صاخبًا دون أي فائدة في العرض.
لا تخف من الإخراج غير المبطن للملفات التي تم إنشاؤها. إذا تمت كتابة جدول بواسطة برنامج نصي ولم تتم قراءته مطلقًا كمصدر، فأوقف تشغيل الحشو واحفظ البايتات.
فرز قبل لصق. تعد إعادة ترتيب الصفوف بنقرة سهم واحدة في كل مرة أمرًا جيدًا لخمسة صفوف ومملة لخمسين صفًا. فرز في جدول البيانات أولاً، ثم الاستيراد.
شاهد صف الرأس الفارغ. مع "؛ الصف الأول هو header"؛ عند إيقاف تشغيله، يصدر المولد رأسًا فارغًا فوق بياناتك، لأن GFM ليس لديه طريقة للتعبير عن جدول بدون رأس. تظهر بعض العارضين ذلك كصف فارغ رفيع. إذا كان الأمر يزعجك، قم بتصدير HTML بدلاً من ذلك، والذي لا يحتاج إلى رأس على الإطلاق.
تحقق من النتيجة المقدمة، وليس المصدر. لا يزال من الممكن أن يؤدي المصدر المبطن الذي يبدو مثاليًا إلى حدوث خطأ إذا كان صف المحدد يحتوي على عدد خاطئ من الخلايا. الصق معاينة أي نظام أساسي تنشر عليه قبل أن تنتهي.
أسئلة وأجوبة
كيف أقوم بإنشاء جدول في Markdown؟
يحتاج جدول Markdown إلى صف رأس، وصف محدد من الواصلات، وصف واحد لكل سجل، مع فصل الخلايا بأحرف الأنابيب. املأ الشبكة في المولد وتكتب الأداة بناء الجملة هذا لك، بما في ذلك صف المحدد وأي وحدات محاذاة.
كيف يمكنني محاذاة الأعمدة في جدول Markdown؟
يتم تعيين المحاذاة باستخدام النقطتين في صف المحدد: النقطتين الموجودتين على اليسار تتم محاذاة اليسار، والنقطتين الموجودتين على كلا الجانبين في المنتصف، والنقطتين الموجودتين على اليمين تتم محاذاة اليمين. اختر محاذاة من رأس عمود في المحرر ويتم إنشاء موضع النقطتين الصحيح تلقائيًا.
هل يمكنني تحويل نطاق Excel أو Google Sheets إلى جدول Markdown؟
نعم. انسخ الخلايا في جدول البيانات والصقها في لوحة الاستيراد. تضع جداول البيانات نصًا مفصولًا بعلامات التبويب على الحافظة ، والتي يكتشفها المستورد تلقائيًا ويحمّلها في الشبكة.
كيف أضع حرف أنبوب داخل خلية طاولة؟
يجب الهروب من الأنبوب الحرفي بشرطة مائلة عكسية وإلا سيقرأه العارض كفاصل عمود. اكتب الأنبوب بشكل طبيعي في المحرر وسيقوم المولد بتسريحه في الإخراج نيابةً عنك.
هل يمكن أن تحتوي خلية جدول Markdown على خطوط متعددة؟
ليس مع الأسطر الجديدة الحقيقية، لأن جداول GFM تتكون من صف واحد فقط لكل سطر. الحل البديل المعتاد هو علامة فاصل سطر HTML داخل الخلية، والتي تقوم هذه الأداة بإدراجها تلقائيًا عندما تحتوي الخلية التي تقوم بلصقها على فاصل أسطر.
لماذا يتم عرض طاولتي كنص عادي على GitHub؟
يكون صف المحدد هو السبب دائمًا تقريبًا: يجب أن يكون السطر الثاني ويجب أن يحتوي على نفس عدد الخلايا الموجودة في الرأس. يمكن أيضًا أن يؤدي وجود سطر فارغ مفقود قبل الجدول إلى إيقافه عند اتباع الجدول لفقرة أو وضعه داخل القائمة.
هل يجب علي حشو الأعمدة بحيث تتجه المصدر؟
لا. يتجاهل العارضون المسافات الإضافية، لذلك يتم عرض الجدول غير المبطن بشكل مماثل. توجد حشوة للبشر الذين يقرؤون الملف الأولي في محرر أو فرق. قم بإيقاف تشغيله باستخدام مفتاح تبديل الإخراج المبطن إذا كنت تفضل المصدر المضغوط.
هل جداول Markdown مدعومة في كل مكان؟
الجداول عبارة عن امتداد GitHub Flavored Markdown وليست جزءًا من مواصفات CommonMark الأصلية. يدعمها GitHub وGitLab وObsidian وNotion وDocusaurus ومعظم مولدات المواقع الثابتة، لكن بعض العارضين الصغار لا يدعمونها. قم بتبديل الإخراج إلى HTML إذا كان جهازك واحدًا منهم.
