Markdown सिंटैक्स

Markdown एक हल्की मार्कअप भाषा है जिसमें एक सरल सिंटैक्स है जो आपको प्रारूपण के बजाय सामग्री पर अधिक ध्यान केंद्रित करने की अनुमति देता है। यह एक पठनीय और लिखने योग्य सादे पाठ प्रारूप का उपयोग करता है, HTML के साथ मिश्रित किया जा सकता है, और HTML, PDF, या अपने स्वयं के .md फ़ाइल प्रारूप में निर्यात किया जा सकता है।

डिज़ाइन दर्शन

Markdown का लक्ष्य "पठनीयता और लेखन में आसानी" है।

पठनीयता सबसे महत्वपूर्ण बात है। Markdown में लिखी गई एक फ़ाइल सादे पाठ के रूप में प्रकाशित होनी चाहिए और ऐसा नहीं लगना चाहिए कि यह टैग या प्रारूपण निर्देशों से भरी हुई है।

Markdown के सिंटैक्स का प्राथमिक डिज़ाइन लक्ष्य इसे यथासंभव पठनीय बनाना है। इस लक्ष्य के आधार पर, Markdown दस्तावेज़ सादे पाठ के रूप में प्रकाशित किए जा सकते हैं बिना यह दिखाए कि वे टैग या प्रारूपण निर्देशों से भरे हुए हैं।
—— John Gruber

HTML संगतता

Markdown के सिंटैक्स का लक्ष्य वेब के लिए उपयुक्त एक लेखन भाषा होना है।

Markdown HTML को प्रतिस्थापित करने का लक्ष्य नहीं रखता, न ही इसके करीब होने का। इसका सिंटैक्स सीमित है और केवल HTML टैग के एक छोटे उपसमुच्चय को कवर करता है।

Markdown द्वारा कवर न किए गए टैग HTML का उपयोग करके दस्तावेज़ में सीधे लिखे जा सकते हैं। यह चिह्नित करने की आवश्यकता नहीं है कि यह HTML है या Markdown; बस टैग सीधे जोड़ें।

उदाहरण के लिए, Markdown फ़ाइल में एक HTML तालिका जोड़ें:

markdown

यह एक नियमित पैराग्राफ है।

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

यह एक और नियमित पैराग्राफ है।

स्वचालित विशेष वर्ण रूपांतरण

HTML फ़ाइलों में, दो वर्णों को विशेष हैंडलिंग की आवश्यकता होती है: < और &।

< खोलने वाले टैग के लिए उपयोग किया जाता है
& HTML इकाइयों के लिए उपयोग किया जाता है

Markdown आपको इन वर्णों को स्वाभाविक रूप से लिखने देता है और आपके लिए रूपांतरण को संभालता है। यदि आप जो & उपयोग करते हैं वह HTML इकाई का हिस्सा है, तो इसे संरक्षित किया जाएगा; अन्यथा, इसे & में परिवर्तित किया जाएगा।

Markdown बुनियादी सिंटैक्स तत्व

Markdown के बुनियादी सिंटैक्स में निम्नलिखित तत्व शामिल हैं:

ब्लॉक तत्व

Markdown शीर्षक - विभिन्न स्तरों के शीर्षक बनाने के लिए # का उपयोग करें
Markdown पैराग्राफ और लाइन ब्रेक - पाठ पैराग्राफ और लाइन ब्रेक नियम
Markdown ब्लॉककोट - ब्लॉककोट बनाने के लिए > का उपयोग करें
Markdown सूचियाँ - क्रमित और अक्रमित सूचियाँ
Markdown कोड ब्लॉक - कोड प्रदर्शित करने के लिए विशेष प्रारूप
क्षैतिज नियम - क्षैतिज रेखाएँ बनाएँ

Markdown इनलाइन तत्व

Markdown जोर - बोल्ड और इटैलिक पाठ
Markdown लिंक - हाइपरलिंक बनाएँ
Markdown छवियाँ - छवियाँ सम्मिलित करें
Markdown इनलाइन कोड - इनलाइन कोड चिह्न

अन्य

Markdown एस्केपिंग - विशेष वर्णों को एस्केप करें
ऑटोलिंक - स्वचालित लिंक पहचान