انتقل إلى المحتوى

منسّق YAML

أعد ضبط مسافات ملف YAML ووحّد شكله مع الاحتفاظ بالتعليقات والمراسي وبنية المستندات المتعددة.

تتم المعالجة محليًا في متصفحك

الخيارات
0 حرف · 0 سطر
ستظهر النتيجة هنا.

ما هي أداة منسّق YAML؟

YAML هو لغة الإعداد في Kubernetes وDocker Compose وGitHub Actions وOpenAPI وأدوات كثيرة أخرى. وهو حساس للمسافات البادئة، فتجعل أخطاء صغيرة (عروض مسافات مختلطة أو تباعد غريب في القوائم السطرية) الملفات صعبة القراءة والمراجعة.

يحلّل هذا المنسّق YAML بمكتبة yaml (YAML 1.2 والمخطط core) ثم يعيد كتابته بمسافتين أو 4 مسافات وبعرض السطر الذي تختاره وترتيب أبجدي اختياري لمفاتيح الخرائط. تُحفظ التعليقات والمراسي (&a) والأسماء المستعارة (*a) ومفاتيح الدمج (<<) والمستندات المتعددة المفصولة بـ ---. ولا يُنفَّذ أي شيء من المستند أبدًا.

كيف تعمل؟

  1. الصق YAML أو افتح ملف .yaml / .yml.
  2. اختر مسافتين أو 4 مسافات وعرض السطر (0 يعطّل الالتفاف) وهل تُرتَّب المفاتيح.
  3. إذا كان YAML غير صالح فاقرأ الخطأ: فهو يعطي السطر والعمود.
  4. انسخ الناتج المنسّق أو نزّل formatted.yaml.

حالات الاستخدام الشائعة

  • توحيد ملفات Kubernetes أو قيم Helm قبل الالتزام.
  • تنظيف docker-compose.yml أو مسار CI بمسافات غير منتظمة.
  • ترتيب مفاتيح إعداد لتُقارَن ملفان بفروقات نظيفة.
  • تحويل مقتطفات بنمط التدفق ({a: 1, b: [2, 3]}) إلى نمط الكتل المقروء بالبيانات نفسها.

أمثلة

جرّب هذا المدخل في الأداة أعلاه:

المدخل
# service config
service:
      name:   api
      ports: [80,   443]
      env:
            - {name: MODE,   value: prod}
            - {name: DEBUG, value: "false"}
limits: &limits
   cpu:  "500m"
   memory: 256Mi
worker:
   <<: *limits
   replicas: 3
المخرج
# service config
service:
  name: api
  ports: [ 80, 443 ]
  env:
    - { name: MODE, value: prod }
    - { name: DEBUG, value: "false" }
limits: &limits
  cpu: "500m"
  memory: 256Mi
worker:
  <<: *limits
  replicas: 3

الخصوصية

تعمل أداة منسّق YAML بالكامل داخل متصفحك. يُعالَج النص أو الملفات التي تقدّمها على جهازك ولا تُرفع ولا تُسجَّل ولا تُخزَّن على خوادمنا.

القيود

قد يغيّر التنسيق نمط علامات الاقتباس أو كتابة بعض القيم (مثلًا 0x1F تصبح 0x1f)، وقد يُطوى النص الطويل عند العرض المختار. ويعيد ترتيب المفاتيح ترتيب الخرائط وقد يؤثر في أدوات تعتمد على الترتيب.

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

هل تُحفظ التعليقات؟

نعم. تبقى التعليقات ملتصقة بالمدخلات التي تخصها حتى عند ترتيب المفاتيح.

أي إصدار YAML يُستخدم؟

YAML 1.2 مع المخطط core، فتكون قيم مثل yes وno وon نصوصًا عادية لا قيمًا منطقية. القيم المنطقية هي true وfalse فقط.

هل من الآمن لصق YAML غير موثوق؟

نعم. تُحلَّل البيانات فقط ولا تُنفَّذ الوسوم المخصصة أبدًا ويُحدَّد توسيع الأسماء المستعارة لإيقاف مستندات «billion laughs».

المزيد من الأدوات في JSON والبيانات →