Markdown: सजावट से पहले पाठ की संरचना तय करें
Markdown नोट और दस्तावेज़ के लिए उपयोगी है क्योंकि उसका स्रोत सामान्य पाठ की तरह पढ़ा जा सकता है। उद्देश्य अधिक चिह्न लगाना नहीं, बल्कि शीर्षक, अनुच्छेद और सूची को अलग पहचान देना है।
शीर्षक केवल बड़े अक्षर नहीं है
दस्तावेज़ के विषय से शुरू करें और अनुभागों को नीचे के शीर्षक-स्तर पर रखें। स्पेस के बाद वाले # और ## अलग स्तर बनाते हैं; हर पंक्ति को मुख्य शीर्षक बनाने से क्रम खो जाता है।
अलग मदों के लिए सूची और उनके संबंध समझाने के लिए अनुच्छेद रखें। फ़ॉर्मैट स्पष्ट वाक्य की मदद करे, उसकी जगह न ले।
संदर्भ: CommonMark 0.31.2 — Structured text, headings and rendering differences
पूर्वावलोकन हर प्रकाशन-प्रणाली नहीं है
Markdown के विस्तार अलग प्रणालियों में भिन्न हैं। एक संपादक में बनी तालिका दूसरे में वैसी ही दिखे, यह आवश्यक नहीं। पाठक जहाँ पढ़ेगा, वहाँ भी जाँचें।
ToolRoof HTML दिखाता और निर्यात करता है, लेकिन दर्ज किया गया कच्चा HTML नहीं चलाता। बाहरी चित्रों की जगह विवरण दिखता है और पूर्वावलोकन में लिंक निष्क्रिय हैं। यह पूरे वेब-पृष्ठ की प्रतिलिपि नहीं बनाता।
संदर्भ: CommonMark 0.31.2 — Structured text, headings and rendering differences
दिखाई गई प्रति के साथ स्रोत भी रखें
Markdown स्रोत बाद के बदलावों की तुलना में काम आता है। HTML प्रस्तुति के लिए है; वापस बदलने पर मूल स्रोत ठीक उसी रूप में मिलना ज़रूरी नहीं।
साझा करने से पहले सामग्री और लिंक जाँचें। पूर्वावलोकन तथ्य, लिंक की सुरक्षा या किसी और की सामग्री इस्तेमाल करने की अनुमति प्रमाणित नहीं करता।
उदाहरण: बैठक का छोटा नोट
# साप्ताहिक योजना, फिर ## प्राथमिकताएँ और अलग पंक्तियों में - सारांश की समीक्षा तथा - मसौदा भेजें लिखें। इससे मुख्य शीर्षक, उपशीर्षक और 2 मदों की सूची बनती है, 4 एक-जैसे अनुच्छेद नहीं।
#साप्ताहिक योजना में स्पेस नहीं है, इसलिए यह ATX शीर्षक नहीं बनता। बैकटिक के बीच कोड केवल पाठ के रूप में दिखता है; दिखने का अर्थ उसका चलना या सही होना नहीं है।