Markdown फ़ॉर्मैट में कॉन्टेंट लिखने की सुविधा मिलती है; HTML एक प्रकाशन प्रारूप है. इसलिए, Markdown सिंटैक्स का मकसद एचटीएमएल में सभी सुविधाएं उपलब्ध कराना नहीं है. यह लिखे गए टेक्स्ट के सबसे ज़्यादा इस्तेमाल होने वाले एलिमेंट है. जब आपको कोई मुश्किल काम करना हो, तो किसी भी इनलाइन एचटीएमएल टैग और ब्लॉक-लेवल के टैग का इस्तेमाल किया जा सकता है. ये टैग, Markdown फ़ाइल में DevSite के साथ काम करते हैं. आपको मार्कडाउन से एचटीएमएल पर स्विच करने के बारे में बताने की कोई ज़रूरत नहीं है. नीचे दिए गए उदाहरण की तरह, बस एचटीएमएल टैग का इस्तेमाल करें.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
इनलाइन एचटीएमएल
इनलाइन एचटीएमएल टैग का इस्तेमाल, मार्कडाउन पैराग्राफ़, लिस्ट आइटम या हेडर में किया जा सकता है. साथ ही, इसमें मार्कडाउन सिंटैक्स (उदाहरण के लिए, **strong**, *emphasis* वगैरह) यह तब मददगार होता है, जब आपको किसी कोड पर ध्यान खींचना हो, जैसा कि नीचे दिए गए उदाहरण में बताया गया है.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
ब्लॉक-लेवल एचटीएमएल
ब्लॉक-लेवल के ऐसे एचटीएमएल टैग जो DevSite के साथ काम करते हैं, उन्हें खाली लाइन के आस-पास के कॉन्टेंट से अलग किया जाना चाहिए. इनलाइन एचटीएमएल टैग के उलट, मार्कडाउन सिंटैक्स (उदाहरण के लिए, **strong**, *emphasis* वगैरह) ब्लॉक-लेवल के एचटीएमएल टैग में, नीचे दिए गए उदाहरण के मुताबिक रेंडर नहीं किए गए हैं.
This is a Markdown paragraph that explains Java format strings:
// required blank line
<pre>
System.out.format("The square of *%d* is *%f*.*%n*", i, r);
</pre>
// required blank line
This is another Markdown paragraph.
सबसे सही तरीके
हमारा सुझाव है कि DevSite पर रेंडरिंग की गड़बड़ियों को रोकने के लिए, Markdown फ़ाइलों में एचटीएमएल को इन तरीकों से फ़ॉर्मैट किया जाए.
काम न करने वाले ब्लॉक-लेवल के एचटीएमएल टैग का इस्तेमाल न करें DevSite कई ब्लॉक-लेवल के एचटीएमएल टैग के साथ काम करता है; लेकिन किसी असमर्थित एचटीएमएल को शामिल करने से या तो आपका एचटीएमएल टेक्स्ट के रूप में रेंडर होगा या कोड काम नहीं करेगा.
इंडेंट करते समय, अतिरिक्त टैब या स्पेस न जोड़ें ब्लॉक-लेवल के स्टार्ट और एंड टैग, टैब या स्पेस से इंडेंट नहीं किए जाने चाहिए. कुछ एडिटर अपने-आप ज़्यादा टैब या स्पेस जोड़ देते हैं — ध्यान रखें!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
याद रखें कि इंडेंट नहीं किया गया कोड रिलेटिव है
उदाहरण के लिए, Markdown में सूचियां बनाते समय आपको ब्लॉक-लेवल के स्टार्ट और एंड टैग को इंडेंट करने की ज़रूरत नहीं है.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
शुरुआती और आखिरी टैग के बीच खाली लाइन न जोड़ें
Markdown और एचटीएमएल के बीच स्विच करते समय ऐसा करना आसान होता है. हालांकि, एक आसान खाली लाइन से पेज को गलत तरीके से रेंडर करना आसान हो सकता है.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.