مولّد جدول محتويات Markdown

كيف يعمل؟

مفيد لإضافة جدول محتويات قابل للنقر تلقائيًا في بداية ملف README طويل أو مقالة تقنية أو توثيق Markdown: الصق المستند كاملًا، انقر على «إنشاء الجدول»، ثم انسخ القائمة النقطية الناتجة في أعلى ملفك. يشير كل عنصر إلى علامة إرساء `#titre-slugifie` المقابلة للعنوان، ويعمل ذلك مباشرة على GitHub وGitLab ومعظم محركات عرض Markdown.

كيف يتم اكتشاف العناوين؟

تفحص الأداة المستند سطرًا بسطر بحثًا عن الأسطر التي تبدأ بواحد أو أكثر من `#` متبوعًا بمسافة (نمط ATX القياسي: `# عنوان`، `## عنوان فرعي`، وما إلى ذلك). لا يتم التعرف على النمط البديل في Markdown حيث يتم وضع خط تحت العنوان باستخدام `===` أو `---` في السطر التالي؛ إذا كنت تستخدم هذا النمط، فحوّل عناوينك أولاً إلى ترميز `#`.

كيف يتم إنشاء روابط الإرساء؟

يتم «تحويل كل عنوان إلى رابط»: تحويله إلى أحرف صغيرة، وإزالة علامات الترقيم، واستبدال المسافات بشرطات. على سبيل المثال، «الخطوة 1: التثبيت!» يصبح الإرساء `etape-1-installation`. إذا نتج عن عنوانين متطابقين نفس الإرساء، تضيف معظم محركات Markdown لاحقة رقمية تلقائيًا (`-1`، `-2`...) للثاني — تحقق من العرض النهائي إذا كان مستندك يحتوي على عناوين مكررة.

يتم إنشاء جدول المحتويات محليًا 100% في متصفحك عبر WebAssembly: لا يغادر محتوى مستندك جهازك أبدًا.