Markdown लिंक सिंटैक्स (हाइपरलिंक)

लिंक सामग्री को जोड़ने के लिए Markdown में महत्वपूर्ण तत्व हैं। विभिन्न लिंक सिंटैक्स को मास्टर करने से आपके दस्तावेज़ अधिक जुड़े और व्यावहारिक हो जाते हैं।

बुनियादी लिंक सिंटैक्स

इनलाइन लिंक

[लिंक पाठ](URL) प्रारूप का उपयोग करके लिंक बनाएँ:

यह [Google](https://www.google.com) पर एक लिंक है।
[GitHub](https://github.com) पर जाएं ओपन सोर्स प्रोजेक्ट देखने के लिए।

रेंडर किया गया आउटपुट:

यह Google पर एक लिंक है। GitHub पर जाएं ओपन सोर्स प्रोजेक्ट देखने के लिए।

शीर्षक के साथ लिंक

URL के बाद एक वैकल्पिक शीर्षक जोड़ें, जो होवर पर दिखाई देता है:

यह एक [शीर्षक के साथ लिंक](https://www.example.com "यह लिंक शीर्षक है") है।

रेंडर किया गया आउटपुट:

यह एक शीर्षक के साथ लिंक है।

संदर्भ-शैली लिंक

बुनियादी संदर्भ-शैली लिंक

लिंक परिभाषा को उपयोग से अलग करें:

यह एक [संदर्भ लिंक][1] है।
यह एक और [संदर्भ लिंक][link-name] है।

[1]: https://www.example.com
[link-name]: https://www.google.com "Google खोज"

रेंडर किया गया आउटपुट:

यह एक संदर्भ लिंक है। यह एक और संदर्भ लिंक है।

निहित लिंक लेबल

जब संदर्भ लेबल alt पाठ के समान हो:

[Google][] पर जाएं खोजने के लिए।
[GitHub][] पर प्रोजेक्ट देखें।

[Google]: https://www.google.com
[GitHub]: https://github.com

रेंडर किया गया आउटपुट:

Google पर जाएं खोजने के लिए। GitHub पर प्रोजेक्ट देखें।

ऑटोलिंक

URL ऑटोलिंक

बस URL टाइप करें, एंगल ब्रैकेट में लपेटें:

<https://www.example.com>
<https://github.com/user/repo>

रेंडर किया गया आउटपुट:

https://www.example.comhttps://github.com/user/repo

ईमेल ऑटोलिंक

संपर्क: <user@example.com>
समर्थन: <support@company.com>

रेंडर किया गया आउटपुट:

संपर्क: user@example.com समर्थन: support@company.com

आंतरिक लिंक

एंकर लिंक

समान पेज पर एक शीर्षक से लिंक करें:

[बुनियादी लिंक सिंटैक्स पर कूदें](#basic-link-syntax)
[सर्वोत्तम प्रथाओं को देखें](#best-practices)

रेंडर किया गया आउटपुट:

बुनियादी लिंक सिंटैक्स पर कूदेंसर्वोत्तम प्रथाओं को देखें

सापेक्ष पथ लिंक

अन्य फ़ाइलों से लिंक करें:

[शीर्षक सिंटैक्स देखें](headings.md)
[होम पर वापस](../index.md)

विशेष लिंक

छवि लिंक

एक छवि को लिंक में लपेटें:

[![छवि विवरण](image.jpg)](https://www.markdownlang.com)

डाउनलोड लिंक

फ़ाइल डाउनलोड से लिंक करें:

[उपयोगकर्ता मैनुअल डाउनलोड करें](files/manual.pdf)
[नमूना कोड प्राप्त करें](examples/demo.zip)

लिंक पाठ प्रारूपण

प्रारूपित लिंक पाठ

यह एक [**बोल्ड लिंक**](https://www.example.com) है
यह एक [*इटैलिक लिंक*](https://www.example.com) है
यह एक [`कोड शैली लिंक`](https://www.example.com) है

रेंडर किया गया आउटपुट:

यह एक बोल्ड लिंक है यह एक इटैलिक लिंक है यह एक कोड शैली लिंक है

बहु-पंक्ति लिंक पाठ

यह एक [बहुत लंबा लिंक पाठ है,
जो लपेटने की आवश्यकता हो सकती है](https://www.example.com)

सामान्य त्रुटियाँ और समाधान

1. असंगत कोष्ठक

❌ त्रुटि:
[लिंक पाठ(https://www.example.com)  ← दायां कोष्ठक गुम

✅ सही:
[लिंक पाठ](https://www.example.com)

2. स्थान मुद्दे

❌ त्रुटि:
[ लिंक पाठ ]( https://www.example.com )  ← अनावश्यक स्थान

✅ सही:
[लिंक पाठ](https://www.example.com)

3. URL एन्कोडिंग

विशेष वर्णों वाले URL के लिए:

❌ संभावित समस्या:
[खोज](https://www.google.com/search?q=markdown)

✅ सुरक्षित:
[खोज](https://www.google.com/search?q=markdown)
या संदर्भ शैली का उपयोग करें:
[खोज][google-search]

[google-search]: https://www.google.com/search?q=markdown

सर्वोत्तम प्रथाएं

1. वर्णनात्मक लिंक पाठ का उपयोग करें

✅ अनुशंसित: वर्णनात्मक पाठ
[आधिकारिक Markdown सिंटैक्स दस्तावेज़ देखें](https://daringfireball.net/projects/markdown/syntax)

❌ अनुशंसित नहीं: सामान्य पाठ
दस्तावेज़ देखने के लिए [यहाँ](https://daringfireball.net/projects/markdown/syntax) क्लिक करें

2. लंबे दस्तावेज़ों के लिए संदर्भ-शैली लिंक का उपयोग करें

✅ अनुशंसित: लंबे दस्तावेज़ों के लिए संदर्भ शैली का उपयोग करें
हमारी अनुसंधान में, हम [Smith et al. के कार्य][smith2020] का संदर्भ लिया,
[Jones का सिद्धांत][jones2019], और [नवीनतम उद्योग रिपोर्ट][industry2021]।

[smith2020]: https://www.markdownlang.com/smith-2020-paper
[jones2019]: https://www.markdownlang.com/jones-theory
[industry2021]: https://www.markdownlang.com/industry-report-2021

3. URL को संक्षिप्त रखें

✅ अनुशंसित: छोटे URL या कस्टम डोमेन का उपयोग करें
[परियोजना होमपेज](https://myproject.com)

✅ स्वीकार्य: लंबे URL के लिए संदर्भ शैली का उपयोग करें
हमारी [विस्तृत विश्लेषण रिपोर्ट][detailed-report] देखें

[detailed-report]: https://company.com/reports/2023/detailed-analysis-q4-performance-metrics

लिंक सत्यापन

लिंक वैधता जांचें

अपने दस्तावेज़ में लिंक नियमित रूप से जांचें:

<!-- अनुशंसित: लिंक स्थिति को चिह्नित करने के लिए टिप्पणियाँ जोड़ें -->
[सक्रिय लिंक](https://www.google.com) <!-- ✓ 2023-01-15 -->
[अप्रचलित लिंक](https://old-site.com) <!-- ⚠️ अमान्य हो सकता है -->

लिंक सत्यापन के लिए उपकरण का उपयोग करें

• linkchecker - कमांड-लाइन लिंक चेकर
• markdown-link-check - Node.js लिंक सत्यापक
• VS Code एक्सटेंशन - रियल-टाइम लिंक सत्यापन

HTML आउटपुट

Markdown लिंक HTML में परिवर्तित हो जाते हैं:

[लिंक पाठ](https://www.example.com "शीर्षक")

परिवर्तित हो जाता है:

<a href="https://www.example.com" title="शीर्षक">लिंक पाठ</a>

उन्नत टिप्स

1. सशर्त लिंक

संदर्भ के आधार पर लिंक जोड़ने का निर्णय लें:

विकास में, [स्थानीय सर्वर](http://localhost:3000) पर जाएं
उत्पादन में, [उत्पादन सर्वर](https://production.example.com) पर जाएं

2. लिंक समूहीकरण

संबंधित लिंक को समूहों में प्रबंधित करें:

<!-- आधिकारिक संसाधन -->
[आधिकारिक वेबसाइट][official]
[आधिकारिक दस्तावेज़][docs]
[आधिकारिक ब्लॉग][blog]

<!-- समुदाय संसाधन -->
[GitHub रेपो][github]
[फोरम][forum]
[समुदाय ब्लॉग][community]

[official]: https://www.markdownlang.com
[docs]: https://docs.example.com
[blog]: https://blog.example.com
[github]: https://github.com/example/project
[forum]: https://forum.example.com
[community]: https://community.example.com

3. बहुभाषी लिंक

दस्तावेज़ देखें: [English](README.md) | [中文](README-zh.md) | [日本語](README-ja.md)

व्यावहारिक उदाहरण

नेविगेशन मेनू

## त्वरित नेविगेशन

**शुरुआत**
- [Markdown क्या है](what-is-markdown.md)
- [संपादक स्थापित करें](install-editor.md)
- [पहला दस्तावेज़](first-document.md)

**सिंटैक्स संदर्भ**
- [बुनियादी सिंटैक्स](basic-syntax.md)
- [विस्तारित सिंटैक्स](extended-syntax.md)
- [सर्वोत्तम प्रथाएं](best-practices.md)

**संसाधन लिंक**
- [आधिकारिक वेबसाइट](https://daringfireball.net/projects/markdown/)
- [ऑनलाइन संपादक](https://dillinger.io/)
- [सिंटैक्स चेकर](https://markdownlint.github.io/)

संदर्भ

## संदर्भ

यह दस्तावेज़ निम्नलिखित संसाधनों पर आधारित है:

1. [आधिकारिक Markdown सिंटैक्स][markdown-syntax] - John Gruber
2. [CommonMark स्पेक][commonmark] - Markdown मानकीकरण
3. [GitHub Flavored Markdown][gfm] - GitHub विस्तारित सिंटैक्स
4. [Markdown गाइड][markdown-guide] - व्यापक सीखने संसाधन

[markdown-syntax]: https://daringfireball.net/projects/markdown/syntax
[commonmark]: https://commonmark.org/
[gfm]: https://github.github.com/gfm/
[markdown-guide]: https://www.markdownguide.org/

अनुशंसित उपकरण

## अनुशंसित उपकरण

### संपादक
- [Typora](https://typora.io/) - WYSIWYG संपादक
- [Mark Text](https://marktext.app/) - मुफ्त ओपन सोर्स संपादक
- [VS Code](https://code.visualstudio.com/) + Markdown एक्सटेंशन

### ऑनलाइन उपकरण
- [Dillinger](https://dillinger.io/) - ऑनलाइन संपादक
- [StackEdit](https://stackedit.io/) - विशेषताओं से भरपूर ऑनलाइन संपादक
- [Markdown से HTML](https://markdowntohtml.com/) - प्रारूप परिवर्तन

### स्थैतिक साइट जेनरेटर
- [VitePress](https://vitepress.dev/) - Vue इकोसिस्टम
- [Docusaurus](https://docusaurus.io/) - React इकोसिस्टम
- [GitBook](https://gitbook.com/) - दस्तावेज़ीकरण प्लेटफ़ॉर्म

संबंधित सिंटैक्स

• छवि सिंटैक्स - छवियाँ सम्मिलित करना
• HTML सिंटैक्स - HTML एम्बेड करना
• फेंस्ड कोड ब्लॉक - कोड हाइलाइटिंग
• ऑटोलिंक - विस्तारित लिंक सुविधाएँ

अभ्यास

निम्नलिखित प्रकार के लिंक बनाने का प्रयास करें:

1. कई बाहरी लिंक के साथ एक संसाधन सूची
2. संदर्भ-शैली लिंक का उपयोग करने वाला एक तकनीकी दस्तावेज़
3. आंतरिक नेविगेशन के साथ एक लंबा दस्तावेज़
4. ईमेल और वेबसाइट लिंक के साथ एक संपर्क पेज