ثلاثة أوضاع عرض
تُعرض مصفوفات JSON من الكائنات على أفضل وجه كجداول Markdown: تستخرج الأداة رؤوس الأعمدة من اتحاد جميع المفاتيح ثم تكتب صفًا واحدًا مفصولًا بالأنابيب لكل كائن. يتبع ترتيب الأعمدة الكائن الأول افتراضيًا مع إلحاق المفاتيح الإضافية. تُعرض القيم المنطقية وقيم null كأحرف حرفية "true" و"false" و"null" لضمان احتواء كل خلية على نص قابل للطباعة.
يُعرض JSON المتداخل — الكائنات داخل كائنات والمصفوفات المختلطة — كقوائم نقطية مسافة بادئة. يصبح كل مفتاح نقطة عنوان وقيمته نقطة فرعية. تصبح مصفوفات القيم الأولية قوائم مضمّنة مدمجة أو نقاطًا متعددة الأسطر بحسب الطول. هذا الوضع مثالي لتصدير الإعدادات وتوثيق استجابات API وإدخالات سجل التغييرات.
يلفّ وضع كتلة الكود JSON في كتلة محاطة بعلامات ``` json ``` مع تلميحات تظليل البنية. يستخدم الشكل المنسَّق بطريقة جميلة (مسافة بادئة بمقدار مسافتين) لتكون المخرجات قابلة للقراءة فورًا في أي معالج Markdown. هذه أسرع طريقة لتضمين عيّنة JSON في README أو صفحة ويكي.
خيارات الجداول والحالات الحدية
عند توليد الجداول يمكن ترتيب الأعمدة أبجديًا أو بترتيب اكتشاف المفاتيح (الافتراضي). يمكنك أيضًا تثبيت أعمدة محددة على اليسار — مفيد عندما يجب أن يكون مفتاح مثل "id" أو "name" دائمًا العمود الأول. تُهرَّب الخلايا التي تحتوي على أحرف الأنبوب تلقائيًا بشرطة مائلة عكسية لمنع كسر الجدول.
تُسلسَل الكائنات المتداخلة داخل خلية جدول كسلسلة JSON مضمّنة مدمجة. يحافظ هذا على جميع البيانات على حساب قابلية القراءة للقيم المتداخلة بعمق. بديلًا عن ذلك يمكنك تفعيل خيار "التسطيح قبل العرض" لاستخدام مفاتيح بترميز النقطة كأعمدة على المستوى الأعلى.
تتراجع مصفوفات الأنواع المختلطة — حيث بعض العناصر كائنات وأخرى قيم أولية — بسلاسة إلى معالج القوائم إذ لا يمكن اشتقاق مجموعة أعمدة موحدة. تختار الأداة دائمًا المخرجات الأكثر قابلية للقراءة وفق شكل البيانات.
سير عمل التوثيق والتقارير
كثيرًا ما تحتاج توثيقات API إلى تحويل أمثلة استجابات JSON إلى جداول مقروءة. الصق JSON الاستجابة وانتقل إلى وضع الجدول وانسخ Markdown مباشرةً إلى منصة توثيقك — Notion أو Confluence أو GitHub Wiki أو README بسيط.
كثيرًا ما يتلقى محللو البيانات تقارير JSON من واجهات برمجية أو قواعد بيانات ويحتاجون إلى مشاركة النتائج مع أصحاب المصلحة غير التقنيين. يجعل التحويل إلى جدول Markdown البيانات مقروءة فورًا في أي أداة دردشة أو بريد إلكتروني أو مولّد موقع ثابت يدعم Markdown.
تستفيد وثائق إعداد المطورين ومراجع الإعدادات وأدلة الترحيل جميعها من جداول Markdown المولّدة آليًا بدلًا من تلك المنسّقة يدويًا. يضمن المحوّل الاتساق ويوفّر الوقت عندما تتغير البيانات الأساسية.