جدول محتويات تلقائي لملفات Markdown

## المشكلة

Markdown لا يملك TOC مدمجا

لا توجد صيغة جدول محتويات أصلية في Markdown. لا يوجد وسم [TOC] في المواصفة. بعض الأدوات تدعمه، لكن كثيرا منها لا يدعمه.

لذلك يلجأ الناس إلى الحيل. أدوات CLI مثل markdown-toc و doctoc تضيف جدول المحتويات داخل الملف نفسه. وفي VS Code توجد إضافات لهذا الغرض.

لكن ذلك ليس تلقائيا فعلا. إما أن تعدل الملف أو تثبت أداة خارجية. وعندما تغير عنوانا، يصبح جدول المحتويات قديما حتى تعيد تشغيل الأداة.

## كيف يتعامل ShowMeMyMD

افتح الملف، وسيكون جدول المحتويات موجودا بالفعل

افتح أي ملف .md يحتوي على عناوين من # إلى ###### و ShowMeMyMD سيولد جدول محتويات قابل للنقر تلقائيا.

لا وسوم، لا إضافات، لا أدوات CLI، ولا أي إعداد. فقط افتح الملف وتنقل.

## لماذا يهم؟

المستندات الطويلة تحتاج تنقلا

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

## بدائل

طرق أخرى للحصول على TOC

## الطريقة الأبسط

فقط افتح ملفك

ShowMeMyMD يولد جدول محتويات من عناوينك تلقائيا. لا تعديل للملف، ولا إضافات، ولا خطوات إضافية. يعمل مع أي بنية عناوين من # إلى ######.

يبقى الجدول دائما محدثا لأنه يتولد من الملف كما هو الآن، لا من نسخة قديمة.

## اقرأ المزيد

• ShowMeMyMD: عارض Markdown على Mac — نظرة كاملة على الميزات
• ورقة Markdown المرجعية — مرجع سريع لكل الصيغ
• عارض Markdown للمطورين — لماذا يختار المطورون ShowMeMyMD