शीर्षक किसी भी Markdown दस्तावेज़ की रीढ़ हैं। वे संरचना को परिभाषित करते हैं, नेविगेशन को सक्षम करते हैं, सुलभता को प्रभावित करते हैं, और SEO को प्रभावित करते हैं। यह मार्गदर्शिका इस बारे में सब कुछ कवर करती है Markdown शीर्षक वाक्यविन्यास, पदानुक्रम के नियम, प्लेटफार्म अंतर और सर्वोत्तम प्रथाएं।
शीर्षक वाक्यविन्यास
Markdown शीर्षकों का उपयोग करें # प्रतीक (ATX-शैली) । संख्या # वर्ण शीर्षक स्तर निर्धारित करता है:
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6यहाँ सेटेक्स्ट शैली भी है (केवल H1 और H2):
Heading 1
=========
Heading 2
---------एटीएक्स-शैली (#) को प्राथमिकता दी जाती है यह अधिक स्पष्ट है और सभी छह स्तरों के लिए काम करता है।
प्रत्येक शीर्षक स्तर का क्या अर्थ है
| स्तर | __पी_ए__ टैग | उद्देश्य |
|---|---|---|
| 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 की अपेक्षा करते हैं। कई H1 दोनों को भ्रमित करते हैं।
शीर्षक पदानुक्रम नियम
हमेशा क्रम में अग्रिम दिशाओं. स्तरों को न छोड़ें:
सही:
# 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 स्वचालित रूप से किसी भी Markdown फ़ाइल के शीर्षकों के ऊपरी बाएं कोने में एक TOC उत्पन्न करता है.
SEO विचार
Markdown के लिए जो स्थैतिक साइटों (Jekyll, Hugo, Astro) में प्रयोग किया जाता है और वेब पर प्रकाशित किया जाता है:
- H1 = पृष्ठ शीर्षक अपना प्राथमिक कीवर्ड शामिल करें। प्रति पृष्ठ एक।
- H2s = प्रमुख खंड स्वाभाविक रूप से द्वितीयक कीवर्ड शामिल करें
- H3s = उपधाराएँ अधिक विशिष्ट विषय
- शीर्षकों को वर्णनात्मक रखें निर्भरताएं कैसे स्थापित करें बीट्स स्थापना
- शीर्षकों को खोज इंजनों द्वारा सूचकांकित किया जाता है उन्हें स्कैन करने योग्य बनाना
देखें Word स्थैतिक साइट जनरेटर के लिए वेब पर Markdown दस्तावेजों को प्रकाशित करने के लिए।
सुलभता
स्क्रीन रीडर उपयोगकर्ता को नेविगेट करने में मदद करने के लिए शीर्षक पदानुक्रम का उपयोग करते हैं। दिशानिर्देश:
- रुख स्तरों (H1 → H3 H2 के बिना) को न छोड़ें
- केवल दृश्य स्वरूपण के लिए शीर्षकों का उपयोग न करें (इसके बजाय बोल्ड या सीएसएस का उपयोग करें)
- शीर्षक पाठ को सार्थक बनाएं से बचें खंड 1, भाग A
- शीर्षकों को संक्षिप्त लेकिन वर्णनात्मक रखें
प्लेटफार्म द्वारा शीर्षक प्रस्तुत करना
| मंच | H1-H6 | ऑटो-आईडी | ऑटो-टोक |
|---|---|---|---|
| GitHub | ✅ | ✅ | ✅ (बटन के माध्यम से) |
| Obsidian | ✅ | ✅ | प्लगइन के माध्यम से |
| GitBook | ✅ | ✅ | ✅ (साइडबार) |
| Notion | केवल H1-H3 | ❌ | ❌ |
| वीएस कोड पूर्वावलोकन | ✅ | ✅ | ❌ |
| __पी_ए__ | ✅ | ✅ | ✅ |
Notion केवल तीन शीर्षक स्तरों का समर्थन करता है (उनके संपादक में शीर्षक 1, 2 और 3 कहा जाता है, जो H1H3 पर मैप करता है) ।
आम गलतियाँ
बाद की जगह को भूल जाना #
#Not a heading ← Missing space
# This is correctके बीच की जगह # और शीर्षक पाठ CommonMark में आवश्यक है।
स्टाइलिंग के लिए शीर्षक का उपयोग करना, संरचना के लिए नहीं
उपयोग ### पाठ को एक वास्तविक उपधारा के बिना थोड़ा छोटा करना दस्तावेज़ संरचना को तोड़ देता है। इसके बजाय स्टाइल किए गए पाठ या सीएसएस कक्षाओं का उपयोग करें.
अति घोंसला लगाना यदि आपको H5 और H6 की आवश्यकता है, तो विचार करें कि क्या सामग्री को अलग-अलग पृष्ठों में विभाजित किया जाना चाहिए।
FAQ
एटीएक्स और सेटेक्स्ट शीर्षक शैलियों के बीच क्या अंतर है?
एटीएक्स उपयोग # वर्ण। छठे पाठ का उपयोग रेखांकित करता है (=== H1 के लिए, --- H2 के लिए) । एटीएक्स को प्राथमिकता दी जाती है क्योंकि यह स्पष्ट है और एच1एच6 के लिए काम करता है।
क्या मुझे कई एच2 मिल सकते हैं? हाँ यही पूरा मकसद है. H2 प्रमुख खंडों को परिभाषित करता है, और एक दस्तावेज़ में आमतौर पर कई होते हैं।
क्या पाठ्यक्रम स्तरों को छोड़ना SEO को प्रभावित करेगा? यह SEO से अधिक प्रत्यक्ष रूप से सुलभता को प्रभावित करता है, लेकिन एक स्वच्छ अर्थ संरचना एक सकारात्मक संकेत है। खोज इंजन अच्छी तरह से संरचित सामग्री को पसंद करते हैं।
मेरे परिवर्तित दस्तावेज़ में सभी शीर्षक एक ही स्तर पर हैं। क्या गलत हुआ? Word दस्तावेज़ में हेडिंग शैलियों के बजाय मैनुअल स्वरूपण का प्रयोग किया गया है. देखें Word से Markdown स्वरूपण गाइड ठीक करने के लिए।
निष्कर्ष
Markdown शीर्षक वाक्यविन्यास में सरल हैं लेकिन प्रभाव में महत्वपूर्ण हैं। दस्तावेज़ के शीर्षक के रूप में एक बार H1 का उपयोग करें, प्रमुख खंडों के लिए H2 और उपखंडों के लिए H3। पदानुक्रम को साफ रखें, कोई स्तर नहीं छोड़ें, और वर्णनात्मक शीर्षक पाठ लिखें। Word दस्तावेजों को परिवर्तित करते समय WordToMD, सुनिश्चित करें कि स्रोत स्वच्छ रूपांतरण के लिए Words अंतर्निहित हेडिंग शैलियों का उपयोग करता है.