محوّل JSON إلى جدول Markdown

ما الذي تفعله الأداة

تصل استجابات API والبيانات المصدّرة والإعدادات غالبًا بصيغة JSON، لكن الجدول أسهل قراءة بكثير في README أو طلب سحب أو صفحة ويكي أو رسالة دردشة. تحوّل هذه الأداة مصفوفة كائنات JSON إلى جدول GitHub Flavored Markdown يُعرض على GitHub وGitLab وNotion وObsidian ومعظم مواقع التوثيق.

يصبح كل كائن صفًا وكل مفتاح عمودًا. تُسطَّح الكائنات المتداخلة إلى أسماء أعمدة منقوطة، وتُهرَّب الخطوط العمودية وفواصل الأسطر في القيم، وتُملأ الأعمدة بمسافات ليبقى نص Markdown الخام متحاذيًا أيضًا.

طريقة الاستخدام

1. الصق JSON، أو ارفع ملف .json، أو انقر مثال.
2. اختر المحاذاة: افتراضية أو يسار أو وسط أو يمين، أو الأرقام إلى اليمين لمحاذاة الأعمدة التي لا تحتوي إلا أرقامًا إلى اليمين.
3. أبقِ تسطيح الكائنات المتداخلة مفعّلًا لتوزيع الحقول المتداخلة على أعمدة، أو أوقفه لعرضها بصيغة JSON.
4. أوقف محاذاة الأعمدة إذا كنت تفضّل صفوفًا مضغوطة بلا حشو.
5. انسخ الجدول أو نزّله ملف .md.

إذا كان JSON غير صالح، تعرض رسالة الخطأ السطر والعمود لتصلحه بسرعة.

مثال

ملف JSON هذا:

[
  { "name": "ripgrep", "stars": 48000, "repo": { "owner": "BurntSushi" } },
  { "name": "fd", "stars": 34000, "repo": { "owner": "sharkdp" }, "tags": ["find"] }
]

يصبح جدول Markdown التالي:

| name    | stars | repo.owner | tags     |
| ------- | ----- | ---------- | -------- |
| ripgrep | 48000 | BurntSushi |          |
| fd      | 34000 | sharkdp    | ["find"] |

يصبح الكائن المتداخل repo عمود repo.owner، وتُكتب المصفوفة tags بصيغة JSON، وفي الصف الأول خلية فارغة لأنه بلا tags.

نصائح

• تُكتب القيم نصًا: تظهر الأرقام والقيم المنطقية كما هي، وتصبح null خلية فارغة.
• الجداول العريضة جدًا صعبة القراءة؛ احذف الحقول غير الضرورية قبل التحويل.
• تُحفظ صيغ Markdown المضمّنة في القيم النصية، مثل **غامق** أو الروابط، وتعرضها معظم أدوات العرض.
• لبيانات CSV، أو لإنشاء جدول HTML، استخدم الأدوات ذات الصلة أدناه.