تحويل CSV إلى جدول Markdown
كتابة جدول Markdown يدويًا تعني عدّ الخطوط العمودية والشرطات في كل سطر. ارفع ملف CSV بدلًا من ذلك واحصل على جدول بصف عناوين وصف فاصل، جاهز للصق في ملف README أو صفحة ويكي أو دفتر ملاحظات.
محوّل البيانات
أو أفلت ملفات CSV, TSV, TXT … هنا ·
الحد الأقصى 95 MB لكل ملف· حتى 20 ملفًا· تُحذف بعد 30 دقيقة
تُعالج الملفات على خوادمنا وتُحذف بعد 30 دقيقة.
الحرف الذي يفصل الأعمدة في ملفات CSV والنصوص، للقراءة والكتابة معًا. الاكتشاف التلقائي يحدده من المدخلات ويكتب الفواصل.
يعمل UTF-8 مع جميع اللغات. اختر UTF-8 with BOM إذا عرض Excel على Windows الحروف المشكولة أو الآسيوية بشكل مشوّه عند فتح ملف CSV.
لمدخلات Excel وODS وNumbers: حوّل الورقة الأولى فقط أو كل الأوراق (ملف CSV لكل ورقة داخل ZIP، أو مفتاح JSON لكل ورقة).
اسم تبويب الورقة في جدول البيانات الجديد، بحد أقصى 31 حرفًا.
مصفوفة كائنات تستخدم أسماء الأعمدة مفاتيح لكل صف؛ ومصفوفة مصفوفات أكثر إحكامًا وتُبقي الترويسة كأول مصفوفة.
اسم العنصر الخارجي الذي يضم كل الصفوف؛ ويصبح كل صف عنصر <row> داخله.
يُستخدم في عبارتي CREATE TABLE وINSERT. حروف وأرقام وشرطات سفلية فقط.
يختلف اقتباس الأسماء وأنواع الأعمدة قليلًا بين قواعد البيانات؛ اختر القاعدة التي ستستورد إليها.
أعد كتابة خلايا التاريخ بصيغة واحدة. صيغة ISO (2026-10-18) هي الأكثر أمانًا لقواعد البيانات والبرمجة؛ وخيار الإبقاء يتركها كما وردت في المصدر.
طريقة استخدام هذه الأداة
- 1
ارفع ملف CSV
أضف ملفات .csv أو .tsv أو ملفات .txt ذات الفواصل، حتى 20 ملفًا دفعة واحدة وبحجم أقصاه 95 MB لكل ملف. يتعرف الكشف التلقائي على الفواصل والفواصل المنقوطة والتبويب والخط العمودي.
- 2
تأكد من صف العناوين
خيار الصف الأول عناوين مفعّل، لذلك يصبح الصف الأول عنوان الجدول. أوقفه من الإعدادات المتقدمة إذا كان ملفك يبدأ بالبيانات.
- 3
حوّل والصق
اضغط تحويل إلى Markdown table، ثم افتح ملف .md والصق الجدول في README أو طلب الدمج أو المشكلة أو الملاحظة.
كيف أحوّل ملف CSV إلى جدول Markdown؟
ارفع ملف CSV واضغط تحويل إلى Markdown table. يصبح الصف الأول عنوان الجدول، ويُضاف تحته صف من الشرطات، ويتحول كل سطر آخر إلى صف تفصل بين خلاياه خطوط عمودية.
لماذا يحوّل المطورون CSV إلى Markdown
يستقر التوثيق غالبًا في ملفات Markdown. يريد المسؤول عن المشروع جدولًا بالإصدارات المدعومة في README، ويلصق المهندس أرقام الأداء في طلب دمج، ويحتفظ الباحث بقائمة قراءة في Obsidian. وتبدأ الأرقام عادةً في جدول بيانات أو في مخرجات CSV لسكربت، وإعادة بنائها يدويًا بخط عمودي بين كل خلية بطيئة وعرضة للأخطاء.
لم يكن في Markdown الأصلي الذي وضعه John Gruber عام 2004 أي جداول. انتشرت صيغة الخط العمودي عبر PHP Markdown Extra وأُدرجت في مواصفات GitHub Flavored Markdown عام 2017، ولهذا تعمل على GitHub ومعظم الأدوات التي تتبعها. إذا جاءت الصفوف من Excel فاحفظها أولًا عبر Excel إلى CSV ثم حوّلها هنا.
مثال على تحويل CSV إلى جدول Markdown
runtime,version,status Python,3.13,مدعوم Python,3.9,انتهى الدعم | أكتوبر 2025 Node.js,22,مدعوم
| runtime | version | status | | --- | --- | --- | | Python | 3.13 | مدعوم | | Python | 3.9 | انتهى الدعم \| أكتوبر 2025 | | Node.js | 22 | مدعوم |
أين يُعرض جدول Markdown المحوَّل
| الجهة | المتطلب | المصدر |
|---|---|---|
| GitHub | يعرض الجداول ذات الخطوط العمودية في ملفات README والمشكلات وطلبات الدمج والويكي، وفق مواصفات GFM. | مواصفات GFM |
| GitLab | يعرض GitLab Flavored Markdown الجداول نفسها في المستودعات والمشكلات وطلبات الدمج. | — |
| Obsidian | يعرض الجداول في وضع القراءة ويتيح تحرير الجداول في المعاينة الحية. | — |
| Jupyter | تعرض خلايا Markdown في الدفاتر الجداول بجانب الشيفرة. | — |
| CommonMark | المواصفات الأساسية لا تتضمن صيغة للجداول؛ تحتاج المُعرِضات إلى امتداد للجداول. | commonmark.org |
معلومات عن صيغتي CSV و Markdown
CSV
قيم مفصولة بفواصل
CSV هو تنسيق نص عادي للجداول، يمثل فيه كل سطر صفًّا وتفصل الفواصل بين الأعمدة. يُستخدم منذ بدايات الحوسبة ووصفه المعيار RFC 4180، مع أن كثيرًا من صيغه تستخدم الفاصلة المنقوطة أو علامات الجدولة وترميزات نصية مختلفة. يمكن لكل جداول البيانات وقواعد البيانات وأدوات التحليل تقريبًا استيراده وتصديره، مما يجعله التنسيق الافتراضي لنقل البيانات بين الأنظمة. يخزّن CSV القيم فقط، دون صيغ حسابية أو تنسيق أو أوراق متعددة أو أنواع بيانات.
- الضغط
- –
- الشفافية
- –
- الحركة
- –
- سنة الظهور
- –
MD
Markdown
Markdown لغة ترميز خفيفة ابتكرها John Gruber عام 2004. تستخدم رموزًا نصية بسيطة، مثل # للعناوين و* للتأكيد و- للقوائم، تبقى مقروءة كنص خام وتتحول بنظافة إلى HTML. وهي المعيار في ملفات README والتوثيق والويكي وتطبيقات الملاحظات وكثير من مولدات المواقع الثابتة. توجد عدة لهجات منها CommonMark وGitHub Flavored Markdown وتختلف في تفاصيل مثل الجداول. يمكن لأي محرر نصوص فتح ملفات .md.
- الضغط
- –
- الشفافية
- –
- الحركة
- –
- سنة الظهور
- 2004 · John Gruber
يُحوَّل CSV إلى Markdown عندما تحتاج مجموعة بيانات صغيرة إلى مكان داخل التوثيق: جدول التوافق في README، أو قائمة الإصدارات في سجل التغييرات، أو طلب دمج يقارن نتائج اختبارات الأداء، أو ملاحظة في قاعدة معرفة شخصية.
التحويل شبه خالٍ من الفقد في القيم، لكنه ليس كذلك في المعنى. يحتفظ CSV بكل صف ليقرأه البرنامج، أما جدول Markdown فهو صورة للبيانات للقراء، وليس فيه أنواع بيانات ولا معادلات ولا دمج للخلايا. احتفظ بملف CSV في المستودع مصدرًا، وأعد توليد الجدول عند تغيّر الأرقام.
الأسئلة الشائعة حول تحويل CSV إلى Markdown
أين تُعرض جداول Markdown بشكل صحيح؟
في أي مكان يدعم فيه المُعرِض امتداد الجداول بالخط العمودي: GitHub وGitLab وObsidian ودفاتر Jupyter، ومولدات المواقع الثابتة مثل MkDocs وHugo. أما المُعرِض الملتزم بـ CommonMark وحده فيعرض الأسطر نفسها نصًا عاديًا تظهر فيه الخطوط العمودية.
ماذا لو احتوت قيمة في ملف CSV على الخط العمودي |؟
الرمز | غير المهرَّب يبدأ خلية جديدة ويزيح كل الأعمدة إلى اليمين. يكتبه المحوّل بالشكل \|، وهو الهروب الذي تحدده مواصفات GitHub Flavored Markdown، فيظهر الخط العمودي نصًا داخل الخلية.
هل يمكنني محاذاة الأرقام إلى اليمين؟
نعم، بتعديل صف الفاصل: ---: يحاذي العمود إلى اليمين، و:---: يوسّطه، و:--- يحاذيه إلى اليسار. أضف النقطتين الرأسيتين بعد التحويل؛ فهما تغيّران طريقة عرض الجدول فقط وليس البيانات.
ما الحجم المناسب لملف CSV ليُعرض كجدول Markdown؟
جداول Markdown مخصصة للقراءة، لذلك تناسبها بضع عشرات من الصفوف وعدد قليل من الأعمدة. الجدول الذي يضم آلاف الصفوف يُحوَّل دون مشكلة لكنه يجعل README صعب التصفح؛ الأفضل أن تضع رابطًا إلى ملف CSV في المستودع وتعرض عينة.
ماذا يحدث لفواصل الأسطر داخل حقل CSV؟
يجب أن يبقى صف جدول Markdown في سطر واحد، لذا لا يمكن الإبقاء كما هي على قيمة CSV بين علامتي اقتباس تمتد على عدة أسطر. استبدل فواصل الأسطر قبل التحويل؛ وفي GitHub يمكنك استخدام <br> داخل الخلية لفرض سطر جديد.
هل يمكنني تحويل الجدول إلى HTML بدلًا من ذلك؟
إذا كان الهدف صفحة ويب أو نظام إدارة محتوى أو بريدًا إلكترونيًا وليس ملف Markdown، فاضبط التحويل إلى على HTML table. وإذا كانت بياناتك بصيغة JSON فصفحة JSON إلى HTML تأتي وهذا الخرج محددًا مسبقًا.