محول CSV إلى Markdown

تعرض ملفات README وأوصاف طلبات السحب ومواقع التوثيق جداول Markdown بشكل جميل - إذا كان من الممكن أن تزعج نفسك بكتابة الأنابيب والشرطات يدويًا. يقرأ هذا المحول ملف CSV، ويأخذ الصف الأول كرأس، ويصدر جدول GitHub Flavoured Markdown مع الصف الفاصل الصحيح. كل خلية محاطة بمحددات |، جاهزة للصق في ملف README أو وصف طلب السحب.

كيف يتم بناء الجدول

  1. 1

    الصق ملف CSV

    الإعدادات الافتراضية لعينة مكونة من ثلاثة أعمدة؛ استبدلها ببياناتك الخاصة.

  2. 2

    اختر المحدد

    فاصلة بشكل افتراضي. اختر من القائمة التبويب أو الفاصلة المنقوطة أو الشرطة العمودية بما يناسب بياناتك.

  3. 3

    الصف 1 هو الرأس

    يتم إصدار الصف الأول كرأس Markdown، متبوعًا بالخط الفاصل `| --- | --- |` المطلوب.

  4. 4

    الصفوف مبطنة للعرض

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

التقديم والمحاذاة وأين ستعمل ولن تعمل

يتم دعم جداول GitHub Flavoured Markdown (GFM) على نطاق واسع ولكنها ليست عالمية. إن معرفة مكان عرضها هو الفرق بين ملف README الواضح وجدار الأنابيب.

مدعوم في

  • طلبات سحب GitHub وGitLab وBitbucket ومواقع الويكي
  • معظم مولدات المواقع الثابتة (Docusaurus، VitePress، MkDocs Material)
  • معاينة VS Code Markdown
  • Notion (عبر اللصق كـ Markdown)

غير مدعوم في

  • CommonMark بدون امتداد GFM
  • Reddit (يستخدم مجموعته الفرعية الخاصة)
  • بعض محركات الويكي القديمة (DokuWiki، MoinMoin)

محاذاة العمود

تدعم جداول GFM المحاذاة اليسرى والوسطى واليمنى عبر النقطتين في الصف الفاصل. يصدر هذا المحول فواصل عادية ---؛ إذا كنت بحاجة إلى المحاذاة، بعد العملية:

بناء الجملة تأثير
:--- محاذاة لليسار
:---: محاذاة للوسط
---: محاذاة لليمين

ابحث عن الخط الفاصل واستبدله بـ | :--- | :---: | ---: | المطابق للأعمدة التي تريد إمالتها.

اقتباسات من الأحرف في خلايا Markdown

  • يجب هروب أحرف التوجيه (|) داخل الخلية كـ \\| لتجنب تقسيم الخلية. لا يفلت المحول منها تلقائيًا، لذا قم بالتنظيف المسبق إذا كانت بياناتك تحتوي على أنابيب.
  • الخطوط الجديدة داخل الخلية تكسر عرض GFM. استبدلها بـ <br> قبل التحويل إذا كنت تريد فواصل الأسطر الناعمة داخل الخلية.
  • العلامات النجمية والشرطات السفلية والعلامات الخلفية تمر عبرها؛ يتم تفسيرها على أنها تأكيد أو كود Markdown. يمكنك الهروب باستخدام شرطة مائلة عكسية إذا كنت تريدها بشكل حرفي.

الأسئلة الشائعة

ليس افتراضيًا - يكون الصف الفاصل عاديًا ---. استبدله بـ :--- أو :---: أو ---: بعد التحويل لتثبيت العمود على اليسار أو الوسط أو اليمين.

يمكنك الهروب منها باستخدام شرطة مائلة عكسية قبل التحويل، وتحويل | إلى \|. وإلا فإن عارض Markdown يعاملهم كفواصل أعمدة ويكسر الجدول.

يتم عرض جداول GFM على GitHub وGitLab ومعظم مولدات المواقع الثابتة وVS Code. ولا يتم عرضها على CommonMark أو Reddit أو بعض مواقع الويكي القديمة بدون مكون إضافي.

نعم، يتم إرسال ملف CSV إلى خادمنا حتى يتمكن المحول من بناء الجدول. لا يتم تخزينه ولا يُضاف إلى رابط الصفحة.

أدوات ذات صلة