مولد فهرس Markdown
إنشاء روابط جدول المحتويات من عناوين Markdown
إدخال Markdown
الفهرس المُنشأ
أمثلة فهرس Markdown
إنشاء روابط مرساة من العناوين. مثال:
عناوين دليل المشروع
إدخال Markdown:
الفهرس المُنشأ:
استخدم تحميل مثال أعلاه لتحميل المزيد من العناوين.
ما هو مولد فهرس Markdown؟
جدول المحتويات (TOC) يساعد القراء على التنقل في المستندات الطويلة. في Markdown تستخدم العناوين من # إلى ######. يفحص مولد الفهرس العناوين وينشئ قائمة بالروابط التي تقود إلى كل قسم. يدعم GitHub Flavored Markdown ومعظم مولدات المواقع الثابتة روابط المرساة المُنشأة من نص العنوان.
تعمل هذه الأداة في المتصفح. الصق Markdown أو ارفع ملفًا؛ يتحدث الفهرس أثناء التحرير. يمكنك تعيين المستويات الدنيا والقصوى للعناوين (مثلاً H2 فقط حتى H4). تُنشأ مراسي الروابط من نص العنوان وتُزال تكرارات العناوين المتشابهة. لتنسيق Markdown استخدم منسق Markdown. للتحويل إلى HTML استخدم Markdown إلى HTML.
كيفية استخدام هذه الأداة
الصق أو ارفع Markdown
الصق Markdown في المحرر الأيسر أو انقر على رفع الملف لتحميل ملف .md أو .markdown أو .txt. استخدم تحميل مثال لتحميل عناوين نموذجية. يتحدث الفهرس تلقائيًا.
اضبط نطاق مستويات العناوين
استخدم أدنى H1–H4 وأقصى H3–H6 لتضمين مستويات العناوين المحددة فقط. مثلاً أدنى H2 وأقصى H4 يتخطى H1 وH5–H6. يساعد ذلك في التركيز في المستندات الطويلة.
انسخ أو نزّل الفهرس
انسخ الفهرس المُنشأ إلى الحافظة أو نزّله. الصقه في بداية ملف README أو مستندك. لتدقيق Markdown استخدم مدقق Markdown. للمساعدة في بناء الجملة راجع Markdown Cheat Sheet.
أين يُفيد إنشاء الفهرس
تستفيد ملفات README على GitHub وصفحات التوثيق والويكي من الفهرس. يمكن للقراء الانتقال إلى الأقسام دون تمرير. تحدد مواصفة CommonMark بناء جملة العناوين؛ يدعم GFM ومعظم أدوات العرض روابط #anchor-slug. تُنشئ مولدات المواقع الثابتة مثل Eleventy وVitePress في الغالب مراسي تلقائيًا.
لإنشاء جداول من CSV أو البيانات المحددة استخدم مولد جدول Markdown. للرجوع السريع إلى بناء الجملة راجع Markdown Cheat Sheet. لتحويل Markdown إلى HTML استخدم Markdown إلى HTML.
الأسئلة الشائعة
كيف تُنشأ مراسي الروابط؟
تُحوَّل العناوين إلى أحرف صغيرة وتُحذف الأحرف الخاصة وتُستبدل المسافات بشرطات. العناوين المكررة تحصل على لاحقة رقمية (مثلاً #intro-1، #intro-2).
هل يعمل مع GitHub؟
نعم. GitHub ينشئ مراسي من العناوين. الصق الفهرس في بداية ملف README؛ ستعمل الروابط في العرض المُصيَّر.
هل تُضمَّن العناوين داخل كتل الكود؟
لا. العناوين داخل أسوار الكود (```) تُتجاهل لمنع الخلط بين أمثلة الكود وبنية المستند.
هل يمكنني تحديد العمق؟
نعم. استخدم القوائم المنسدلة للمستوى الأدنى/الأقصى. مثلاً أدنى H2 وأقصى H4 ينشئ فهرسًا بعناوين H2 وH3 وH4 فقط.
هل تُرسل بياناتي إلى الخادم؟
لا. يتم إنشاء الفهرس بالكامل في المتصفح. لا تُرسل أي بيانات أو تُحفظ.
الأدوات ذات الصلة
اعرف المزيد: CommonMark، مواصفة CommonMark، GitHub Flavored Markdown، Markdown Guide، GitHub، W3C HTML، Eleventy، VitePress.