Markdown फ़ॉर्मेटर कैसे इस्तेमाल करें
- Markdown टेक्स्ट पेस्ट करें।
- bullet चिह्न, नंबरिंग और emphasis स्टाइल चुनें।
- प्रीव्यू देखें, फिर फ़ॉर्मेट किया Markdown कॉपी करें।
Markdown फ़ॉर्मेटर की खूबियाँ
- Setext हेडिंग को ATX में बदलता है और "#Heading" की स्पेसिंग ठीक करता है
- bullet चिह्न (-, * या +) सामान्य करता है और क्रमांकित सूचियाँ दोबारा नंबर करता है
- टेबल के कॉलम अलाइन करता है और अलाइनमेंट पंक्तियाँ सामान्य करता है
- कोड के बाहर bold (**) और italic (_ या *) चिह्न एकसमान करता है
- ट्रेलिंग व्हाइटस्पेस (हार्ड लाइन ब्रेक बचाते हुए) और अतिरिक्त खाली लाइनें हटाता है
- फ़ॉर्मेट किए डॉक्यूमेंट का लाइव, sanitised HTML प्रीव्यू
- fenced और indented कोड ब्लॉक कभी नहीं बदले जाते
Markdown फ़ॉर्मेटर का उदाहरण
बिखरी सूची और टेबल को सुव्यवस्थित करना
इनपुट:
Title
=====
* item one
* item two
|a|b|
|-|-|
|long cell|x|आउटपुट:
# Title
- item one
- item two
| a | b |
| --------- | --- |
| long cell | x |Markdown फ़ॉर्मेटर के बारे में अक्सर पूछे जाने वाले सवाल
फ़ॉर्मेटर क्या-क्या सामान्य करता है?
हेडिंग स्टाइल (Setext → ATX, # के बाद एक स्पेस), bullet चिह्न, क्रमांकित सूची की नंबरिंग, bold/italic चिह्न, टेबल कॉलम अलाइनमेंट, horizontal rule, ट्रेलिंग व्हाइटस्पेस और ज़रूरत से ज़्यादा खाली लाइनें।
क्या कोड ब्लॉक छेड़े जाते हैं?
नहीं। fenced (``` या ~~~) और indented कोड ब्लॉक हूबहू कॉपी होते हैं, आख़िर के स्पेस सहित।
क्या प्रीव्यू भरोसेमंद न होने वाले Markdown के साथ सुरक्षित है?
हाँ। सोर्स में मौजूद raw HTML एस्केप कर दिया जाता है, और javascript:, data: या vbscript: वाले लिंक/इमेज URL निष्क्रिय कर दिए जाते हैं।
कौन-सा Markdown flavour इस्तेमाल होता है?
CommonMark, आम GitHub एक्सटेंशन के साथ: टेबल, strikethrough, task list और autolink।
क्या हार्ड लाइन ब्रेक सुरक्षित रहते हैं?
हाँ। जो लाइनें दो या ज़्यादा स्पेस पर ख़त्म होती हैं उनमें ठीक दो स्पेस रखे जाते हैं ताकि ब्रेक बना रहे।
तकनीकी नोट्स
प्रीव्यू रेंडरर ख़ास तौर पर बनाया गया CommonMark का उपसमुच्चय है (हेडिंग, पैराग्राफ़, emphasis, कोड, सूचियाँ, task list, लिंक, इमेज, टेबल, block quote, horizontal rule)। raw HTML एस्केप होता है और लिंक में सिर्फ़ http(s), mailto और relative URL की अनुमति है, इसलिए भरोसेमंद न होने वाले डॉक्यूमेंट स्क्रिप्ट इंजेक्ट नहीं कर सकते।