ما هي هرمية عناوين Markdown؟

يتم تعريف عناوين Markdown باستخدام رمز # — واحد # لـ H1، واثنان لـ H2، وحتى ستة لـ H6. تشكل العمود الفقري الهيكلي للمستند، مشابهة لجدول المحتويات. يستخدم المستند المنظم جيداً العناوين بترتيب منطقي متداخل: H1 كعنوان المستوى الأعلى، H2 للأقسام الرئيسية، H3 للأقسام الفرعية، وهكذا.

عندما تُستخدم العناوين بترتيب غير صحيح — على سبيل المثال، الانتقال من H2 مباشرة إلى H4 — فإنه يكسر المخطط الدلالي ويمكن أن يضر بإمكانية الوصول (تعتمد قارئات الشاشة على ترتيب العناوين) وتحسين محركات البحث (تستخدم محركات البحث العناوين لفهم هرمية المحتوى). يجعل تصور الهرمية من السهل اكتشاف هذه المشاكل قبل النشر.

وصف الأداة

تحلل هذه الأداة نص Markdown وتعرض جميع العناوين المستندة إلى # كشجرة تفاعلية قابلة للطي. يمكنك أن ترى في لمحة كيفية تنظيم مستندك، وتحديد مستويات العناوين المفقودة، وحساب عدد العناوين من كل نوع.

يتم تجاهل العناوين داخل كتل الأكواد المحاطة (``` أو ~~~)، لذا يعكس الناتج فقط هيكل المستند الفعلي.

أمثلة

الإدخال:

# Getting Started

## Installation

### Prerequisites

### Steps

## Configuration

# Advanced Usage

## Plugins

شجرة الناتج:

H1  Getting Started
├── H2  Installation
│   ├── H3  Prerequisites
│   └── H3  Steps
└── H2  Configuration
H1  Advanced Usage
└── H2  Plugins

الميزات

  • يحلل جميع عناوين H1–H6 من أي نص Markdown
  • يعرض العناوين كشجرة تفاعلية قابلة للطي مع عناصر تحكم التوسيع/الطي
  • يتخطى العناوين داخل كتل الأكواد المحاطة (``` و ~~~)
  • يعرض عدد العناوين لكل مستوى (H1–H6) والعدد الإجمالي للعناوين
  • يدعم عمق التوسيع الأولي القابل للتكوين

حالات الاستخدام

  • مراجعة التوثيق — تحقق من أن ملف README طويل أو صفحة توثيق لها هيكل عناوين متسق وجيد الترتيب قبل النشر.
  • تدقيق تحسين محركات البحث — تحقق من أن المحتوى المخصص للويب يستخدم H1 واحد وتداخل منطقي H2/H3 لمساعدة زحافات محركات البحث على فهم هيكل الصفحة.
  • فحص إمكانية الوصول — تأكد من عدم تخطي مستويات العناوين، وهي مشكلة وصول شائعة يتم الإبلاغ عنها بواسطة إرشادات WCAG.

كيفية العمل

تمسح الأداة مصدر Markdown سطراً تلو الآخر. أي سطر يبدأ بحرف واحد إلى ستة # متبوعاً بمسافة يتم التعامل معه كعنوان. تقوم خوارزمية ذات مسارين أولاً بجمع جميع العناوين بالترتيب، ثم تبني شجرة بتتبع مكدس عقد الوالدين المفتوحة — يتم دمج كل عنوان جديد تحت أقرب عنوان سابق من مستوى أقل.

نصائح

  • الصق ملف Markdown كاملاً، بما في ذلك المقدمة — تتجاهل الأداة الأسطر غير العنوان، لذا لن تؤثر مقدمة YAML والنص الأساسي على الناتج.
  • استخدم إعداد عمق التوسيع الأولي لطي المستويات العميقة تلقائياً والحصول على نظرة عامة على المستوى الأعلى أولاً.
  • قم بإلغاء تحديد توسيع الكل قبل استكشاف مستند كبير للبدء بحالة مطوية والتعمق في أقسام محددة.