Markdown शीर्षक पदानुक्रम क्या है?

Markdown शीर्षक # प्रतीक का उपयोग करके परिभाषित किए जाते हैं — H1 के लिए एक #, H2 के लिए दो, H6 तक छह। वे एक दस्तावेज़ की संरचनात्मक रीढ़ बनाते हैं, जो विषय सूची के समान है। एक अच्छी तरह से संरचित दस्तावेज़ शीर्षकों को एक तार्किक, नेस्टेड क्रम में उपयोग करता है: H1 शीर्ष-स्तरीय शीर्षक के रूप में, H2 प्रमुख अनुभागों के लिए, H3 उप-अनुभागों के लिए, और इसी तरह।

जब शीर्षकों का उपयोग क्रम से बाहर किया जाता है — उदाहरण के लिए, H2 से सीधे H4 पर जाना — यह शब्दार्थ रूपरेखा को तोड़ता है और पहुंच को नुकसान पहुंचा सकता है (स्क्रीन रीडर शीर्षक क्रम पर निर्भर करते हैं) और SEO (खोज इंजन सामग्री पदानुक्रम को समझने के लिए शीर्षकों का उपयोग करते हैं)। पदानुक्रम की कल्पना करने से प्रकाशन से पहले इन समस्याओं को स्पॉट करना आसान हो जाता है।

उपकरण विवरण

यह उपकरण Markdown पाठ को पार्स करता है और सभी #-आधारित शीर्षकों को एक इंटरैक्टिव, संक्षिप्त पेड़ के रूप में प्रदर्शित करता है। आप एक नज़र में देख सकते हैं कि आपका दस्तावेज़ कैसे संरचित है, छोड़े गए शीर्षक स्तरों की पहचान करें, और गिनें कि प्रत्येक प्रकार के कितने शीर्षक मौजूद हैं।

बाड़ लगाए गए कोड ब्लॉक (``` या ~~~) के अंदर के शीर्षकों को अनदेखा किया जाता है, इसलिए आउटपुट केवल वास्तविक दस्तावेज़ संरचना को प्रतिबिंबित करता है।

उदाहरण

इनपुट:

# Getting Started

## Installation

### Prerequisites

### Steps

## Configuration

# Advanced Usage

## Plugins

आउटपुट पेड़:

H1  Getting Started
├── H2  Installation
│   ├── H3  Prerequisites
│   └── H3  Steps
└── H2  Configuration
H1  Advanced Usage
└── H2  Plugins

विशेषताएं

  • किसी भी Markdown पाठ से सभी H1–H6 शीर्षकों को पार्स करता है
  • शीर्षकों को विस्तार/संक्षिप्त नियंत्रण के साथ एक इंटरैक्टिव, संक्षिप्त पेड़ के रूप में प्रस्तुत करता है
  • बाड़ लगाए गए कोड ब्लॉक (``` और ~~~) के अंदर के शीर्षकों को छोड़ता है
  • प्रति-स्तर शीर्षक गणना (H1–H6) और कुल शीर्षक गणना दिखाता है
  • कॉन्फ़िगर करने योग्य प्रारंभिक विस्तार गहराई का समर्थन करता है

उपयोग के मामले

  • दस्तावेज़ समीक्षा — जांचें कि एक लंबे README या दस्तावेज़ पृष्ठ में प्रकाशन से पहले एक सुसंगत, अच्छी तरह से आदेशित शीर्षक संरचना है।
  • SEO ऑडिटिंग — सत्यापित करें कि वेब के लिए अभिप्रेत सामग्री एक एकल H1 और तार्किक H2/H3 नेस्टिंग का उपयोग करती है ताकि खोज इंजन क्रॉलर पृष्ठ संरचना को समझ सकें।
  • पहुंच जांच — सुनिश्चित करें कि शीर्षक स्तरों को छोड़ा नहीं जाता है, जो WCAG दिशानिर्देशों द्वारा चिह्नित एक सामान्य पहुंच समस्या है।

यह कैसे काम करता है

उपकरण Markdown स्रोत को पंक्ति दर पंक्ति स्कैन करता है। कोई भी पंक्ति जो एक से छह # वर्णों के साथ शुरू होती है और उसके बाद एक स्थान होता है, एक शीर्षक के रूप में माना जाता है। एक दो-पास एल्गोरिथ्म पहले क्रम में सभी शीर्षकों को एकत्र करता है, फिर खुले माता-पिता नोड्स के एक स्टैक को ट्रैक करके एक पेड़ बनाता है — प्रत्येक नया शीर्षक निकटतम पूर्ववर्ती शीर्षक के नीचे नेस्ट किया जाता है।

सुझाव

  • एक पूर्ण Markdown फ़ाइल पेस्ट करें, फ्रंट मैटर सहित — उपकरण गैर-शीर्षक पंक्तियों को अनदेखा करता है, इसलिए YAML फ्रंट मैटर और बॉडी पाठ आउटपुट को प्रभावित नहीं करेंगे।
  • प्रारंभिक विस्तार गहराई सेटिंग का उपयोग करके गहरे नेस्टिंग स्तरों को स्वचालित रूप से संक्षिप्त करें और पहले एक उच्च-स्तरीय अवलोकन प्राप्त करें।
  • एक बड़े दस्तावेज़ की खोज शुरू करने से पहले सभी को विस्तृत करें को अनचेक करें और संक्षिप्त शुरू करें और विशिष्ट अनुभागों में ड्रिल करें।