العناوين هي العمود الفقري لأي وثيقة Markdown. إنها تحدد الهيكل، وتمكن من الملاحة، وتؤثر على إمكانية الوصول، وتؤثر على SEO. هذا الدليل يغطي كل شيء حول Markdown العناوين الجملة، قواعد التسلسل الهرمي، الاختلافات في المنصات، وأفضل الممارسات.
صيغة العنوان
Markdown العناوين تستخدم # رمز (أسلوب ATX). عدد # الحروف تحدد مستوى العنوان:
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6وهناك أيضا نمط ستة نصوص (H1 و H2 فقط):
Heading 1
=========
Heading 2
---------نمط ATX (#) يُفضل هو أكثر وضوحاً ويعمل على جميع المستويات الستة.
ما يعنيه كل مستوى من المستويات
| مستوى | HTML العلامة | الغرض |
|---|---|---|
| H1 | <h1> | عنوان الصفحة أو المستند |
| H2 | <h2> | القسم الرئيسي |
| H3 | <h3> | الجزء الفرعي داخل H2 |
| H4 | <h4> | الفرع الفرعي ضمن H3 |
| H5 | <h5> | نادرا ما تستخدم في الممارسة العملية |
| H6 | <h6> | تقريباً لم يحتاجه |
تستخدم معظم الوثائق H1H3 فقط. H4H6 عادة ما يشير إلى أن هيكل الوثيقة عميق جدا.
H1: واحد لكل صفحة
يجب أن يظهر عنوان H1 مرة واحدة بالضبط لكل وثيقة Markdown. يمثل عنوان المستند أو الموضوع الرئيسي للصفحة.
جيد:
# How to Convert Word to Markdownتجنب:
# Section One
...
# Section Two ← Don't use multiple H1sتتوقع محركات البحث وأدوات إمكانية الوصول H1 واحدًا لكل صفحة. العديد من H1s يخلط بين الاثنين.
قواعد التسلسل الهرمي للمقالات
دائماً تقدموا في التسلسل لا تتخطى المستويات
صحيح:
# Document Title
## Section
### Subsection
#### Detailغير صحيح:
# Document Title
#### Jumped to H4 ← Skips H2 and H3إن تخطي مستويات العناوين يخرق ملامح الوثيقة ويفشل في توجيهات إمكانية الوصول WCAG.
تحويل Word العناوين إلى Markdown
عند تحويل مستند Word باستخدام WordToMD، Words المدمج في أنماط العنوان خريطة مباشرة:
| Word النمط | Markdown الناتج |
|---|---|
| البند 1 | # Heading |
| البند 2 | ## Heading |
| البند 3 | ### Heading |
| الطبيعي + الشجاعة | **Bold text** (لا عنوان) |
المشكلة الأكثر شيوعًا: الكتاب يدويًا يزيدون حجم الخط بدلاً من تطبيق نمط العنوان. يخلق هذا النص الذي يبدو وكأنه عنوان في Word ولكنه يتحول إلى نص جليد عادي في Markdown. انظر Word إلى Markdown دليل التنسيق عن كيفية إصلاح هذا
هويات العناوين والروابط المربكة
معظم معالجات Markdown تولد تلقائيًا معرفات من نص العنوان:
## Getting Startedالمولدات: <h2 id="getting-started">Getting Started</h2>
يمكنك أن تربطها:
See the [Getting Started section](#getting-started).قواعد الهويات التي يتم إنشاؤها تلقائياً:
- الحروف الصغيرة كلها
- استبدال الفراغات بالهدايا
- حروف خاصة معزولة باستثناء العبارات
أمثلة:
## API Reference→#api-reference## What's New?→#whats-new## Step 1: Install→#step-1-install
جدول المحتوى
بالنسبة إلى المستندات الطويلة، قم بإنشاء TOC باستخدام روابط الرأس:
## Table of Contents
- [Installation](#installation)
- [Configuration](#configuration)
- [Basic Settings](#basic-settings)
- [Advanced Options](#advanced-options)
- [Usage](#usage)
- [FAQ](#faq)GitHub ينشئ تلقائياً TOC في الزاوية العلوية اليسرى من أي ملف Markdown مع العناوين.
SEO الاعتبارات
لـ Markdown المستخدمة في المواقع الثابتة (Jekyll, Hugo, Astro) ونشرت على الويب:
- H1 = عنوان الصفحة ضع كلمة رئيسية. واحد لكل صفحة
- H2s = الأقسام الرئيسية إدراج الكلمات الرئيسية الثانوية بشكل طبيعي
- H3s = أقسام فرعية مواضيع أكثر تحديداً
- حافظ على العناوين وصفية كيفية تثبيت الاعتمادات ضربات التثبيت
- يتم إدراج العناوين بواسطة محركات البحث تجعلها قابلة للتحليل
انظر Word إلى مولد موقع ثابت للنشر Markdown المستندات على شبكة الإنترنت.
إمكانية الوصول
قراء الشاشة يستخدمون تسلسل التسلسل الهرمي للرأس لمساعدة المستخدمين على التنقل. المبادئ التوجيهية:
- لا تتخطى مستويات التوجه (H1 → H3 بدون H2)
- لا تستخدم العناوين فقط للتنسيق البصري (استخدم الشجاعة أو CSS بدلاً من ذلك)
- جعل عنوان النص معنى تجنب الفصل 1، الجزء A
- حافظ على العناوين موجزة ولكنها وصفية
عرض العناوين حسب المنصة
| المنصة | H1-H6 | هويات تلقائية | التشغيل التلقائي |
|---|---|---|---|
| GitHub | ✅ | ✅ | ✅ (من خلال الزر) |
| Obsidian | ✅ | ✅ | عبر المكونات الإضافية |
| GitBook | ✅ | ✅ | ✅ (الصفحة الجانبية) |
| Notion | H1-H3 فقط | ❌ | ❌ |
| VS عرض مُقدّم للشفرة | ✅ | ✅ | ❌ |
| Confluence | ✅ | ✅ | ✅ |
Notion يدعم ثلاثة مستويات فقط من العناوين (تسمى العناوين 1 و 2 و 3 في محررها ، والترتيب إلى H1H3).
الأخطاء الشائعة
نسيان الفراغ بعد #
#Not a heading ← Missing space
# This is correctالمساحة بين # ويتطلب نص العنوان في CommonMark.
استخدام العناوين للتصميم وليس الهيكل
استخدام ### جعل النص أصغر قليلاً دون أن يكون جزءاً فرعياً فعلياً يكسر هيكل الوثيقة. استخدم النص النمطي أو فئات CSS بدلاً من ذلك.
الإفراط في العش إذا كنت بحاجة إلى H5 و H6 ، فكر فيما إذا كان يجب تقسيم المحتوى إلى صفحات منفصلة.
FAQ
ما هو الفرق بين أسلوب ATX و Setext؟
استخدامات ATX # شخصيات يشدد على استخدامات النص السادس (=== لـ H1، --- لـ H2). يتم تفضيل ATX لأنها غير واضحة وتعمل مع H1H6.
هل يمكنني الحصول على H2s متعددة؟ نعم هذا هو الهدف H2 يحدد الأقسام الرئيسية، والوثيقة عادة ما يكون عدة.
هل تخطي مستويات الاتجاه يؤثر على SEO؟ يؤثر على إمكانية الوصول أكثر من SEO مباشرة، ولكن هيكل معنى نظيف هو إشارة إيجابية. محركات البحث تفضل المحتوى المنظم بشكل جيد.
وثيقتي المحوّلة لديها جميع العناوين على نفس المستوى. ما الذي حدث؟ استخدمت وثيقة Word التنسيق اليدوي بدلاً من أنماط العنوان. انظر Word إلى Markdown دليل التنسيق من أجل العلاج.
النتيجة
Markdown العناوين بسيطة في الجملة ولكنها مهمة في التأثير. استخدم H1 مرة واحدة كعنوان الوثيقة، H2 للأقسام الرئيسية، و H3 للأقسام الفرعية. حافظ على التسلسل الهرمي نظيفاً، لا تخطي مستويات، واكتب نص عنوان وصفي. عند تحويل Word المستندات مع WordToMD، تأكد من أن المصدر يستخدم Words المدمج في أنماط العنوان لتحويل نظيف.