मार्कडाउन एक हल्का फ़ॉर्मेटिंग सिंटैक्स है जो README, ब्लॉग पोस्ट, चैट मैसेज, डॉक्यूमेंटेशन, और अनगिनत अन्य जगहों के पीछे है जहां आप बिना रॉ HTML लिखे सरल, पठनीय फ़ॉर्मेटिंग चाहते हैं। चूंकि मार्कडाउन प्लेन टेक्स्ट है, इसे कहीं भी लिखना आसान है — लेकिन सिंटैक्स को थोड़ा गलत करना और प्रकाशित करने तक इसे नोटिस न करना भी उतना ही आसान है। यह प्रीव्यूअर आपके टाइप करते ही आपके मार्कडाउन को सोर्स के साथ साथ रेंडर करता है, ताकि आप फ़ॉर्मेटिंग गलतियों को तुरंत पकड़ सकें — # के बाद गायब स्पेस, बंद न हुआ कोड फेंस, या ऊपर के पैराग्राफ से अलग न हुई लिस्ट — इससे पहले कि आप किसी README को कमिट करें, कोई पोस्ट प्रकाशित करें, या फ़ॉर्मेटेड मैसेज भेजें।

"## Hello This is **bold** and this is *italic*." टाइप करने पर एक स्तर-2 हेडिंग के बाद बोल्ड और इटैलिक टेक्स्ट वाला एक पैराग्राफ रेंडर होता है।

बायाँ पैनल आपका कच्चा Markdown सोर्स टेक्स्ट दिखाता है, और दायाँ पैनल इसे रीयल टाइम में फ़ॉर्मेटेड HTML के रूप में रेंडर करता है। हर कीस्ट्रोक प्रीव्यू को तुरंत अपडेट करता है, ताकि आप हर सिंटैक्स तत्व का प्रभाव तुरंत देख सकें। सामान्य रेंडरिंग समस्याएं आमतौर पर स्पेसिंग से जुड़ी होती हैं। अधिकांश रेंडरर्स के लिए पैराग्राफ और उसके बाद आने वाली लिस्ट के बीच एक खाली लाइन आवश्यक है। हेडिंग में # प्रतीकों के बाद एक स्पेस चाहिए। कोड फेंस (```) को कोड ब्लॉक रेंडरिंग शुरू करने के लिए अपनी खुद की लाइन पर होना चाहिए। प्रीव्यू इस बात का करीबी अनुमान है कि आपका Markdown अधिकांश प्लेटफ़ॉर्म (GitHub, Slack, Discord आदि) पर कैसा दिखेगा, लेकिन प्रत्येक प्लेटफ़ॉर्म का अपना रेंडरर होता है जिसमें थोड़ा अंतर होता है। बुनियादी फ़ॉर्मेटिंग से परे किसी भी चीज़ के लिए हमेशा लक्षित प्लेटफ़ॉर्म पर अंतिम जाँच करें।