হেডিং আইডি

হেডিং আইডি মার্কডাউনের একটি এক্সটেনশন ফিচার যা হেডিংয়ে কাস্টম আইডেন্টিফায়ার যোগ করতে দেয়, সঠিক লিঙ্ক তৈরি এবং ডকুমেন্ট স্ট্রাকচার নিয়ন্ত্রণে সুবিধা করে।

বেসিক সিনট্যাক্স

হেডিং আইডি যোগ করা

হেডিং আইডি ব্রেস সিনট্যাক্স ব্যবহার করে, হেডিং টেক্সটের পরে রাখা হয়:

## আমার হেডিং {#custom-id}

রেন্ডারিং ইফেক্ট:

HTML আউটপুটে এই কাস্টম আইডি হেডিং এলিমেন্টে যোগ করা হবে:

<h2 id="custom-id">আমার হেডিং</h2>

মাল্টি-লেভেল হেডিং আইডি

সব স্তরের হেডিংয়ে কাস্টম আইডি যোগ করা যেতে পারে:

# প্রথম স্তরের হেডিং {#first-level}

## দ্বিতীয় স্তরের হেডিং {#second-level}

### তৃতীয় স্তরের হেডিং {#third-level}

#### চতুর্থ স্তরের হেডিং {#fourth-level}

অ্যাপ্লিকেশন সিনারিও

অ্যাঙ্কর লিঙ্ক তৈরি করা

কাস্টম আইডি দিয়ে, আপনি ডকুমেন্টের নির্দিষ্ট অংশে লিঙ্ক তৈরি করতে পারেন:

[আমার হেডিংয়ে যেতে ক্লিক করুন](#custom-id)

...অন্য কন্টেন্ট...

## আমার হেডিং {#custom-id}

রেন্ডারিং ইফেক্ট:

লিঙ্কে ক্লিক করলে সরাসরি custom-id সহ হেডিংয়ে চলে যাবে।

নির্দিষ্ট সেকশনে বাহ্যিক লিঙ্ক

কাস্টম আইডি বাহ্যিক ডকুমেন্ট থেকে নির্দিষ্ট কন্টেন্টে লিঙ্ক করা সহজ করে:

[অন্য ডকুমেন্টের নির্দিষ্ট সেকশনে লিঙ্ক](other-doc.html#specific-section)

URL এর মাধ্যমে নির্দিষ্ট সেকশন শেয়ার করা

আইডি সহ হেডিং URL এর মাধ্যমে অন্যদের সাথে শেয়ার করা যেতে পারে, ডকুমেন্টের নির্দিষ্ট সেকশনে নির্দেশ করে:

https://www.markdownlang.com/documentation.html#installation-guide

উন্নত ব্যবহার

মাল্টি-ওয়ার্ড হেডিং আইডি

হেডিংয়ে একাধিক শব্দ থাকলে, হেডিং আইডি সাধারণত হাইফেন ব্যবহার করে সংযুক্ত করে:

## ইনস্টলেশন এবং কনফিগারেশন গাইড {#installation-and-configuration}

টেবিল অফ কন্টেন্ট জেনারেশন এবং হেডিং আইডি

অনেক মার্কডাউন প্রসেসর স্বয়ংক্রিয়ভাবে হেডিং কন্টেন্ট থেকে আইডি তৈরি করে। কাস্টম আইডির মাধ্যমে, আপনি নিশ্চিত করতে পারেন যে টেবিল অফ কন্টেন্ট লিঙ্ক হেডিং কন্টেন্ট পরিবর্তনে প্রভাবিত হয় না:

## শুরু করার গাইড {#getting-started}

এমনকি যদি আপনি পরে হেডিং পরিবর্তন করেন "শুরু করা", লিঙ্কটি বৈধ থাকে কারণ আইডি একই থাকে।

আন্তর্জাতিককরণ এবং নন-ইংরেজি ক্যারেক্টার

নন-ইংরেজি হেডিংয়ের জন্য, কাস্টম আইডি বিশেষভাবে দরকারী কারণ তারা স্থিতিশীল ইংরেজি আইডেন্টিফায়ার প্রদান করে:

## ইনস্টলেশন নির্দেশাবলী {#installation}

## ব্যবহার গাইড {#usage}

## প্রায়শই জিজ্ঞাসিত প্রশ্ন {#faq}

কম্প্যাটিবিলিটি এবং ইমপ্লিমেন্টেশন পার্থক্য

বিভিন্ন প্ল্যাটফর্মে সাপোর্ট স্ট্যাটাস

প্ল্যাটফর্ম/টুল	হেডিং আইডি সাপোর্ট	সিনট্যাক্স
GitHub Markdown	✅	{#id}
GitLab Markdown	✅	{#id}
Jekyll (kramdown)	✅	{:#id} বা {#id}
Hugo	✅	{#id}
CommonMark	❌	সমর্থিত নয়
VitePress	✅	{#id}
Pandoc	✅	{#id}

অটোমেটিক আইডি জেনারেশন নিয়ম

কাস্টম আইডি না থাকলে, বেশিরভাগ মার্কডাউন প্রসেসর হেডিং টেক্সট থেকে স্বয়ংক্রিয়ভাবে আইডি তৈরি করে:

১. ছোট হাতের অক্ষরে রূপান্তর ২. বিশেষ ক্যারেক্টার অপসারণ বা প্রতিস্থাপন ৩. স্পেস হাইফেন দিয়ে প্রতিস্থাপন ৪. ডুপ্লিকেট হাইফেন অপসারণ ৫. আইডি অনন্যতা নিশ্চিত করা (সাধারণত সংখ্যা স্যাফিক্স যোগ করে)

উদাহরণস্বরূপ:

হেডিং	অটো-জেনারেটেড আইডি
## শুরু করা	#getting-started
## FAQ এবং সাহায্য	#faq-help
## দ্রুত শুরু	#quick-start বা #section-1 (প্ল্যাটফর্ম অনুযায়ী ভিন্ন)

সেরা অনুশীলন

হেডিং আইডি নেমিং কনভেনশন

✅ সুপারিশকৃত অনুশীলন:

১. **সংক্ষিপ্ত বর্ণনামূলক আইডি ব্যবহার করুন**:
   - `{#installation}`
   - `{#api-reference}`
   - `{#troubleshooting}`

২. **সামঞ্জস্যপূর্ণ নেমিং স্টাইল বজায় রাখুন**:
   - সব ছোট হাতের
   - শব্দ আলাদা করতে হাইফেন ব্যবহার করুন
   - আন্ডারস্কোর বা ক্যামেলকেস এড়িয়ে চলুন

৩. **আইডি স্থিতিশীলতা বজায় রাখুন**:
   - ঘন ঘন আইডি পরিবর্তন এড়িয়ে চলুন
   - হেডিং টেক্সট পরিবর্তন করার সময় মূল আইডি সংরক্ষণ করুন

❌ এড়ানো উচিত:

১. বিশেষ ক্যারেক্টার ব্যবহার করা (যেমন `!@#$%^&*()`)
২. নন-ডেসক্রিপ্টিভ আইডি ব্যবহার করা (যেমন `{#section1}`)
৩. অত্যধিক দীর্ঘ আইডি তৈরি করা
৪. স্পেস বা বিরামচিহ্ন ব্যবহার করা

ডকুমেন্ট স্ট্রাকচার এবং হেডিং আইডি

বড় ডকুমেন্টের জন্য, নেভিগেশন সহজ করতে মূল অধ্যায়ে স্ট্যান্ডার্ডাইজড আইডি ব্যবহার করা সুপারিশ করা হয়:

# প্রোডাক্ট ডকুমেন্টেশন {#product-docs}

## ভূমিকা {#introduction}

## ইনস্টলেশন {#installation}

### Windows ইনস্টলেশন {#installation-windows}

### macOS ইনস্টলেশন {#installation-macos}

### Linux ইনস্টলেশন {#installation-linux}

## কনফিগারেশন {#configuration}

## API রেফারেন্স {#api-reference}

## প্রায়শই জিজ্ঞাসিত প্রশ্ন {#faq}

ব্যবহারিক অ্যাপ্লিকেশন উদাহরণ

টেকনিক্যাল ডকুমেন্টেশনে হেডিং আইডি

টেকনিক্যাল ডকুমেন্টেশনে হেডিং আইডি ব্যবহারকারীদের নির্দিষ্ট সেকশনে সরাসরি লিঙ্ক করতে সাহায্য করে:

# API ডকুমেন্টেশন {#api-documentation}

## প্রমাণীকরণ {#authentication}

### API কী পাওয়া {#get-api-key}

### OAuth প্রমাণীকরণ {#oauth}

## এন্ডপয়েন্ট {#endpoints}

### ব্যবহারকারী এন্ডপয়েন্ট {#endpoints-users}

### প্রোডাক্ট এন্ডপয়েন্ট {#endpoints-products}

একাডেমিক পেপারে হেডিং আইডি

একাডেমিক পেপার উদ্ধৃতি এবং ক্রস-রেফারেন্স তৈরি করতে হেডিং আইডি ব্যবহার করতে পারে:

# গবেষণা পদ্ধতি {#methodology}

[গবেষণা ফলাফল](#results) এ বর্ণিত হিসাবে, আমাদের পদ্ধতি একাধিক টেস্ট কেসে ভালো পারফর্ম করে।

...

# গবেষণা ফলাফল {#results}

এই সেকশনে আমাদের [গবেষণা পদ্ধতি](#methodology) এ বর্ণিত পরীক্ষামূলক ফলাফল উপস্থাপন করা হয়েছে।

সাধারণ সমস্যার সমাধান

হেডিং আইডি কাজ করছে না

আপনার হেডিং আইডি যদি কাজ না করে:

১. প্ল্যাটফর্ম কাস্টম হেডিং আইডি সমর্থন করে কিনা পরীক্ষা করুন ২. সিনট্যাক্স সঠিক কিনা নিশ্চিত করুন (সাধারণত {#id}) ৩. আইডিতে অবৈধ ক্যারেক্টার নেই কিনা যাচাই করুন ৪. ভিন্ন মার্কডাউন প্রসেসর ব্যবহার করার চেষ্টা করুন

আইডি কনফ্লিক্ট

একই ডকুমেন্টে একাধিক অভিন্ন আইডি থাকলে, এটি অনির্দেশিত লিঙ্কিং আচরণ সৃষ্টি করতে পারে:

## ইস্যু {#issue} <!-- প্রথম আইডি -->

...

## সাধারণ ইস্যু {#issue} <!-- ডুপ্লিকেট আইডি, সমস্যা সৃষ্টি করতে পারে -->

আইডি কনফ্লিক্ট এড়ানোর সমাধান:

## ইস্যু {#issue-description}

...

## সাধারণ ইস্যু {#common-issues}

স্পেস এবং বিশেষ ক্যারেক্টার

কিছু মার্কডাউন প্রসেসর আইডিতে স্পেস এবং বিশেষ ক্যারেক্টার সামঞ্জস্যপূর্ণভাবে হ্যান্ডল করে না:

<!-- কিছু প্ল্যাটফর্মে সমস্যা হতে পারে -->
## উন্নত সেটিংস {#advanced settings}

<!-- নিরাপদ পদ্ধতি -->
## উন্নত সেটিংস {#advanced-settings}

সম্পর্কিত সিনট্যাক্স

• লিঙ্ক - বেসিক লিঙ্ক সিনট্যাক্স
• টেবিল অফ কন্টেন্ট - অটো-জেনারেটেড টেবিল অফ কন্টেন্ট
• ফুটনোট - রেফারেন্স এবং ব্যাখ্যা যোগ করা

টুলস এবং প্লাগিন

অটো-জেনারেটেড টেবিল অফ কন্টেন্ট

অনেক টুল হেডিং এবং হেডিং আইডির উপর ভিত্তি করে স্বয়ংক্রিয়ভাবে টেবিল অফ কন্টেন্ট তৈরি করতে পারে:

[[toc]]

# অধ্যায় ১ {#chapter-1}

## সেকশন ১.১ {#section-1-1}

# অধ্যায় ২ {#chapter-2}

হেডিং আইডি চেকিং টুলস

• markdownlint: হেডিং আইডি সামঞ্জস্যতা চেক করতে কনফিগার করা যেতে পারে
• remark-lint: হেডিং আইডি চেকিং এবং অটো-ফিক্সিং প্রদান করে
• markdown-toc: লিঙ্ক সহ স্বয়ংক্রিয়ভাবে টেবিল অফ কন্টেন্ট তৈরি করে

---

হেডিং আইডি মার্কডাউন ডকুমেন্টের ব্যবহারযোগ্যতা এবং অ্যাক্সেসিবিলিটি উন্নত করার একটি গুরুত্বপূর্ণ টুল। স্ট্যান্ডার্ডাইজড হেডিং আইডি ব্যবহার করার মাধ্যমে, আপনি স্থিতিশীল লিঙ্ক স্ট্রাকচার তৈরি করতে পারেন যা নেভিগেশন এবং রেফারেন্সিং সহজ করে, আপনার ডকুমেন্টকে আরও পেশাদার এবং ব্যবহারকারী-বান্ধব করে তোলে।