مولّد فهرس المحتوى Markdown

مولّد فهرس المحتوى Markdown

أنشئ فهرس محتوى Markdown من العناوين الموجودة في مستند. الصق محتوى Markdown أو افتح ملفاً، ثم اختر ما إذا كنت تريد تضمين عنوان H1، وستتم إضافة قائمة منفصلة من روابط التمرير (anchor links). يُعد هذا الأداة المركّزة لإنشاء مسودات لهوامش ملفات README، والتوثيق الفني، والملاحظات، ومحتوى المواقع الثابتة.

يوضح هذا الدليل سير العمل المتكامل في المتصفح، ومحتوى الناتج، وما يجب التحقق منه قبل مشاركة الملف. الأداة مخصّصة بصراحة لمهمة ملف واحدة واضحة. لا تضيف بعنففة ميزات تحرير أو تحويل أو رفع أو تخزين سحابي غير مرتبطة. هذا النطاق الضيّق يجعل المدخلات والمخرجات أسهل للفهم، ويُتيح لك طريقة عملية للتحقق من الملف الذي تم تنزيله.

كيفية الاستخدام

ابدأ بنسخة من الملف الذي تريد معالجته. قد يحتاج الصفحة إلى تحميل مكتبة متصفح قبل أن تصبح الإجراء متاحاً، خاصة في مهام PDF أو الفيديو. اتبع الخطوات التالية:

1. الصق محتوى Markdown في محرر الإدخال أو انقر "Open" لتحميل ملف .md أو .markdown.
2. راجع العناوين المصدرية وتأكد من استخدام صيغة ATX القياسية مثل ## القسم.
3. فعّل خيار "Include the H1 heading" عندما يُراد أن يظهر عنوان المستند في القائمة.
4. انقر "Generate Table of Contents" واستعرض الروابط في لوحة المخرجات.
5. انسخ الناتج إلى مستندك أو حمّله كملف Markdown منفصل.

استخدم ملفاً صغيراً ممثلاً أولاً عندما يكون المستند مهماً أو معقداً بشكل غير معتاد. انتظر حتى يظهر إشعار الحالة بأن المعالجة قد انتهت قبل إغلاق التبويب. إذا أبلغ المتصفح عن خطأ فكّ التشفير، أو ذاكرة، أو توافق، فجارِب ملفاً أصغر أو تنسيق مصدر أكثر شيوعاً. الملف الأصلي لا يُستبدل بالتنزيل، لذا احتفظ به حتى يتم فحص الناتج.

حالات الاستخدام المناسبة

تفيد هذه الأداة في مهام تحضير الملفات المركّزة والقابلة للتكرار مثل:

• إنشاء قائمة تنقل لملف README على GitHub أو صفحة توثيق مشروع.
• بناء Outline سريع من ملاحظات الاجتماعات، أو ورقة دورة تعليمية، أو دليل تقني طويل.
• تجديد فهرس المحتويات بعد إضافة العناوين أو إعادة ترتيبها.
• إعداد محتوى Markdown لمولّد مواقع ثابتة أو قاعدة معرفية.

هي ليست بديلاً عن محرر سطح المكتب الكامل عندما تحتاج إلى خط زمني متعدد المسارات، أو طبوغرافيا متقدمة، أو نماذج PDF معقدة، أو إدارة ألوان احترافية، أو ضمانات تحليل بيانات تعريفية جنائية، أو ضمان انتقال دقيق لكل ميزة ملف خصوصية. استخدم المهمة المحددة التي تناسب هدفك، وقارن الملف المنزّل بالمصدر قبل الاعتماد عليه.

تنسيق المخرجات

المخرجات هي Markdown UTF-8 يحتوي على رابط نقطي واحد لكل عنوان تم كشفه. تُعترف بعناوين ATX من H1 إلى H6 خارج الكتل البرمجية المشبّكة (fenced code blocks). التزيّن يمثل عمق العنوان بالنسبة لأول عنوان تم العثور عليه، ويتلقى النص المكرر من العناوين لاحقة رقمية لتمكين تمييز الروابط. قواعد ancora تختلف قليلاً بين GitHub وGitLab ومكتبات Markdown ومولّدات المواقع الثابتة، لذا اعرض المستند النهائي في المنصة التي سيُنشر عليها. نص Markdown المصدر لا يُعاد كتابته.

التنزيل هو ملف أو حزمة جديدة؛ ولا يُعدّل الملف المحدد في لوحة الإدخال. أسماء الملفات تُنشأ من اسم المصدر عندما يكون ذلك عملياً، مع لاحقة محددة بالمهمة لتسهيل التمييز بين الأصل والناتج. قد يحتوي ناتج ZIP على أكثر من أصل مُولّد ويجب فتحه للتأكد من وجود الملفات المتوقعة. للمخرجات النصية، راجع إنهاء الأسطر والتشفير والتزيّن وأي صيغة خاصة بالمنصة بعد التنزيل. للمخرجات البصرية أو المستندية، افحص الأبعاد وترتيب الصفحات والتشغيل والخطوط والروابط والشفافية وغيرها من الميزات المهمة لوجهتك.

الخصوصية

يتم تحليل النص في المتصفح ولا يُرسَل إلى خدمة كتابة AI أو API Markdown عن بعد في هذه الدورة. الملف المحدد قد يبقى في ذاكرة الصفحة حتى يتم إغلاق التبويب. تجنّب لصق بيانات اعتماد سرية، أو معلومات عملاء خاصة، أو مواد قانونية غير منشورة، أو نصوص حساسة أخرى على جهاز عام. ناتج الأداة ليس أكثر خصوصية من الجهاز وجلسة المتصفح المستخدم لإنشائه.

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

ملاحظات الجودة والتوافق

يستخدم المولّد عمداً كشف عناوين محافظاً. لا يرسم كل تمديد Markdown، ولا يستنتج عناوين من النص العريض، ولا يفحص عناصر العناوين HTML، ولا يضمن توافق قواعد slug المخصصة مع منصة النشر الخاصة بك. العناوين داخل الكتل البرمجية المشبّكة يتم تجاهلها، لكن التداخل غير المعتاد للكتل أو HTML المُولّد قد يتطلب تدقيقاً يدوياً. راجع علامات الترقيم والعناوين المكررة وأهداف الروابط قبل النشر.

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