ما الذي تفعله الأداة
كتابة جداول Markdown يدويًا مملة: كل صف يحتاج إلى خطوط عمودية، والسطر الثاني إلى شرطات، ومحاذاة الأعمدة يدويًا تستغرق وقتًا طويلًا. تحوّل هذه الأداة بيانات CSV أو TSV إلى جدول GitHub Flavored Markdown يمكنك لصقه في README أو طلب سحب أو تذكرة أو صفحة ويكي أو أي توثيق يستخدم Markdown.
يُحلَّل CSV بشكل صحيح، فتُعالَج الحقول المقتبسة التي تحتوي على فواصل وعلامات الاقتباس المضاعفة والخلايا متعددة الأسطر. ويُملأ الناتج بمسافات لتتحاذى الأعمدة حتى في النص العادي، ما يسهّل قراءة الجدول وتعديله لاحقًا.
طريقة الاستخدام
- الصق CSV أو TSV، أو ارفع ملف
.csvأو.tsv، أو انقر مثال. - اختر المحاذاة: افتراضية أو يسار أو وسط أو يمين، أو الأرقام إلى اليمين لمحاذاة الأعمدة التي لا تحتوي إلا أرقامًا إلى اليمين.
- أبقِ الصف الأول ترويسة مفعّلًا إذا كان الصف الأول يحوي أسماء الأعمدة، وإلا ستصبح الترويسة Column 1 وColumn 2 وهكذا.
- أوقف محاذاة الأعمدة إذا كنت تفضّل صفوفًا مضغوطة بلا حشو.
- انسخ الجدول أو نزّله ملف
.md.
تُكمَل الصفوف التي تحتوي خلايا أقل من الترويسة بخلايا فارغة، لذا يبقى الجدول صالحًا دائمًا.
مثال
ملف CSV هذا:
Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlierيصبح جدول Markdown التالي مع محاذاة الأرقام إلى اليمين:
| Tool | Stars | Notes |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd | 34000 | find \| but friendlier |تبقى الفاصلة داخل الحقل المقتبس في الخلية، ويُهرَّب الخط العمودي، ويحصل عمود الأرقام على العلامة --: ليُحاذى إلى اليمين عند العرض.
نصائح
- علامات المحاذاة في الصف الثاني (
:--و:-:و--:) تحدد محاذاة كل عمود في الجدول المعروض. - تُحفظ صيغ Markdown المضمّنة داخل الخلايا، مثل
**غامق**والشيفرة المضمّنة والروابط، وتعرضها معظم أدوات العرض. - الجداول العريضة جدًا صعبة القراءة على الشاشات الصغيرة؛ فكّر في تقسيم الأعمدة على عدة جداول.
- لإنشاء جدول HTML بدلًا من ذلك، أو لتحويل مصفوفة JSON إلى جدول Markdown، استخدم الأدوات ذات الصلة أدناه.
الأسئلة الشائعة
› ما نوع Markdown الذي يستخدمه الجدول؟
جداول الخط العمودي في GitHub Flavored Markdown (GFM)، وتدعمها أيضًا GitLab وBitbucket وNotion وObsidian وDocusaurus وMkDocs ومعظم مولّدات المواقع الثابتة. لا يملك CommonMark المجرد صيغة للجداول.
› ماذا يحدث للخطوط العمودية وفواصل الأسطر داخل الخلايا؟
الخط العمودي سيُنهي الخلية، لذا يُكتب \|. لا يُسمح بفواصل الأسطر داخل صف الجدول، لذا تتحول إلى وسوم <br> يعرضها GitHub ومعظم أدوات العرض كسطر جديد.
› لماذا تبقى الأعمدة الصينية أو اليابانية أو الكورية متحاذية؟
عند تفعيل محاذاة الأعمدة تُملأ الخلايا حسب عرض العرض: تُحسب أحرف شرق آسيا العريضة عمودين، فيبقى نص Markdown متحاذيًا في محرر بخط ثابت العرض. أما الجدول المعروض فيبدو متطابقًا في الحالتين.
› هل يمكنني تحويل TSV منسوخ من Excel أو جداول بيانات Google؟
نعم. الخلايا المنسوخة من جدول بيانات تفصلها علامات Tab، ويُكتشف الفاصل تلقائيًا. ويمكنك أيضًا اختيار Tab صراحةً.