DOCX को Markdown में बदलें
डॉक्यूमेंटेशन को Word से Git रिपॉज़िटरी में ले जाने का पहला कदम है हर .docx को Markdown में बदलना। यह कन्वर्टर # हेडिंग, पाइप टेबल और इमेज लिंक के साथ CommonMark-स्टाइल टेक्स्ट बनाता है, जिसे आप सीधे कमिट कर सकते हैं।
डॉक्यूमेंट कन्वर्टर
या PDF, DOC, DOCX … फ़ाइलें यहाँ ड्रop करें ·
प्रति फ़ाइल अधिकतम 95 MB· अधिकतम 20 फ़ाइलें· 30 मिनट बाद हटा दी जाती हैं
फ़ाइलें हमारे सर्वर पर प्रोसेस होती हैं और 30 मिनट बाद हटा दी जाती हैं।
150 DPI पर A4 पेज करीब 1240 × 1754 px का बनता है। प्रिंटिंग के लिए 300 चुनें।
पूरी फ़ाइल बदलें या सिर्फ़ कुछ पेज या स्लाइड (PDF और प्रेज़ेंटेशन इनपुट के लिए)।
बदलने के लिए पेज या स्लाइड, जैसे 1-3, 5, 8-10।
UTF-8 हर भाषा के लिए काम करता है। अगर Windows पर Excel या Notepad में अक्षर बिगड़े दिखें तो UTF-8 with BOM चुनें; पुराने एन्कोडिंग सिर्फ़ पुराने सॉफ़्टवेयर के लिए हैं।
macOS, Linux और कोड एडिटर के लिए LF; पुराने Windows प्रोग्राम, जैसे क्लासिक Notepad, के लिए CRLF।
कॉमा मानक है। जिन देशों में दशमलव कॉमा से लिखा जाता है (जर्मनी, फ़्रांस, ब्राज़ील) वहाँ Excel के लिए सेमीकोलन चुनें।
कई शीट वाला Excel इनपुट: सभी बदलें (हर शीट के लिए एक सेक्शन या फ़ाइल) या सिर्फ़ पहली।
इस टूल का उपयोग कैसे करें
- 1
Word फ़ाइलें अपलोड करें
20 तक .docx या .doc फ़ाइलें जोड़ें, हर फ़ाइल 95 MB तक। Markdown में ट्रैक किए गए बदलाव दिखाने का कोई तरीका नहीं है, इसलिए पहले Word में उन्हें स्वीकार या अस्वीकार कर दें।
- 2
टेक्स्ट विकल्प जाँचें
फ़ॉर्मेटिंग Simple पर, टेक्स्ट एन्कोडिंग UTF-8 पर और लाइन एंडिंग LF पर रहती है, यही संयोजन Git और स्टैटिक साइट जनरेटर को चाहिए। तस्वीरें फ़ोल्डर में पाने के लिए इमेज शामिल करें चालू रखें।
- 3
कन्वर्ट करें और अनज़िप करें
MD में बदलें दबाएँ। हर डॉक्यूमेंट .md फ़ाइल और उसकी इमेज के साथ एक ZIP में मिलता है; उसे अपने docs फ़ोल्डर में अनज़िप करें और commit करें।
Word डॉक्यूमेंट को Markdown में कैसे बदलें?
.docx अपलोड करें और MD में बदलें दबाएँ। आपको # हेडिंग, लिस्ट, लिंक और टेबल वाली .md फ़ाइल मिलती है, और उसके बगल के फ़ोल्डर में इमेज, सब एक ZIP में।
docs-as-code के लिए DOCX को Markdown में बदलें
टीमें docs-as-code एक ही कारण से अपनाती हैं: तब दस्तावेज़ कोड के बगल में रहते हैं, उन्हीं pull request से गुज़रते हैं और उसी रिलीज़ के साथ जाते हैं। .docx यह तोड़ देता है, क्योंकि वह XML हिस्सों की ZIP है जिसे Git अपठनीय बाइनरी की तरह रखता है। एक शब्द का बदलाव भी बिना पढ़ने लायक diff के बदली हुई फ़ाइल दिखता है, और एक साथ एडिट करने वाले दो लोग अपना काम मर्ज नहीं कर सकते।
Markdown सादा टेक्स्ट है, इसलिए हर एडिट लाइन के बदलाव के रूप में दिखता है। 2014 में यह कहीं ज़्यादा अनुमान-योग्य हो गया, जब John MacFarlane और अन्य ने CommonMark प्रकाशित किया, जो उस सिंटैक्स का सटीक विनिर्देश है जिसे Gruber ने दस साल पहले ढीले ढंग से बताया था। GitHub ने 2017 में अपना GitHub Flavored Markdown स्पेक CommonMark पर आधारित किया और पाइप टेबल, टास्क लिस्ट और स्ट्राइकथ्रू जोड़े, जो आज ज़्यादातर README में होते हैं।
अगर आपकी सामग्री उलटी दिशा में जानी है, यानी Markdown से Word में काम करने वाले रिव्यूअर के पास, तो Markdown से DOCX इस्तेमाल करें। रिपॉज़िटरी की जगह वेब पेज के लिए DOCX से HTML ज़्यादा स्टाइलिंग बचाता है।
Markdown आउटपुट कैसा दिखता है
## रिलीज़ चेकलिस्ट रिलीज़ टैग करने से पहले ये बातें पक्की करें: - **main** पर टेस्ट पास हों - चेंजलॉग में हर मर्ज हुआ PR हो | स्टेप | ज़िम्मेदार | | --- | --- | | Build | CI | | Publish | Maintainer | 
बदला गया Markdown कहाँ दिखेगा
| संस्था | आवश्यकता | स्रोत |
|---|---|---|
| GitHub | GitHub Flavored Markdown से रिपॉज़िटरी की README.md और हर .md फ़ाइल को रेंडर करता है | github.com |
| Hugo | CommonMark-अनुरूप पार्सर से .md कंटेंट फ़ाइलों से पेज बनाता है | gohugo.io |
| Jekyll | front matter वाली .md फ़ाइलों को पेज बनाता है; GitHub Pages का इंजन | jekyllrb.com |
| Docusaurus | अपने docs फ़ोल्डर की .md और .mdx फ़ाइलों को डॉक्यूमेंटेशन पेज की तरह पढ़ता है | docusaurus.io |
DOCX
Microsoft Word दस्तावेज़
DOCX, Office 2007 से Microsoft Word का डिफ़ॉल्ट दस्तावेज़ फ़ॉर्मैट है, जो Office Open XML मानक (ECMA-376, ISO/IEC 29500) पर आधारित है। यह XML फ़ाइलों का एक ZIP पैकेज है, जिसमें टेक्स्ट, स्टाइल, इमेज, टेबल, कमेंट और ट्रैक किए गए बदलाव रहते हैं। दफ़्तरों, स्कूलों और नौकरी के आवेदनों में एडिट होने वाले दस्तावेज़ों के लिए यह सबसे आम फ़ॉर्मैट है। जटिल फ़ॉर्मैटिंग में Word, Google Docs, LibreOffice और Pages के बीच लेआउट थोड़ा खिसक सकता है। ज़्यादातर वर्ड प्रोसेसर DOCX फ़ाइलें खोल लेते हैं।
- कंप्रेशन
- –
- ट्रांसपेरेंसी (पारदर्शिता)
- –
- एनिमेशन
- –
- शुरुआत का वर्ष
- 2007 · Microsoft
MD
Markdown
Markdown एक हल्की मार्कअप सिंटैक्स है, जिसे John Gruber ने 2004 में बनाया। इसमें सादे टेक्स्ट के चिह्न इस्तेमाल होते हैं, जैसे हेडिंग के लिए #, ज़ोर देने के लिए * और सूची के लिए -, जो कच्चे टेक्स्ट में भी पढ़ने योग्य रहते हैं और HTML में साफ़ बदल जाते हैं। README फ़ाइलों, डॉक्यूमेंटेशन, विकी, नोट ऐप और कई स्टैटिक साइट जनरेटर में यही मानक है। CommonMark और GitHub Flavored Markdown जैसी कई बोलियाँ हैं, जो टेबल जैसी बातों में अलग होती हैं। .md फ़ाइलें किसी भी टेक्स्ट एडिटर में खुल जाती हैं।
- कंप्रेशन
- –
- ट्रांसपेरेंसी (पारदर्शिता)
- –
- एनिमेशन
- –
- शुरुआत का वर्ष
- 2004 · John Gruber
DOCX को Markdown में तब बदला जाता है जब डॉक्यूमेंट कोड वर्कफ़्लो में जाता है: README, docs साइट या Git में रखा नॉलेज बेस, जहाँ सादे टेक्स्ट का diff देखा जा सकता है, pull request में रिव्यू हो सकता है और कई टूल उसे रेंडर कर सकते हैं।
Word के वे फ़ीचर जिनका Markdown में कोई विकल्प नहीं है
कन्वर्ट करने से पहले इनकी तैयारी करें
- फ़ॉन्ट, रंग और पेज लेआउट हट जाते हैं; Markdown संरचना बताता है, और रूप साइट की थीम तय करती है
- ट्रैक किए गए बदलाव और कमेंट साथ नहीं जाते, इसलिए पहले Word में उन्हें निपटा लें
- हेडर, फ़ुटर और पेज नंबर की .md फ़ाइल में कोई जगह नहीं है
- टेक्स्ट बॉक्स और रैप की हुई इमेज सामान्य पैराग्राफ़ और इमेज लिंक बन जाते हैं
- हाथ से फ़ॉर्मेट की गई हेडिंग, यानी Heading 2 की जगह बोल्ड 16 pt, बोल्ड टेक्स्ट बनकर आती हैं, इसलिए पहले असली हेडिंग स्टाइल लगाएँ
- अंडरलाइन की Markdown में कोई सिंटैक्स नहीं है, वह हटा दी जाती है या HTML के रूप में रखी जाती है
DOCX को Markdown में बदलने से जुड़े सवाल
DOCX से MD आउटपुट कौन-सा Markdown फ्लेवर इस्तेमाल करता है?
हेडिंग, इमफ़ेसिस, लिस्ट, लिंक और कोड CommonMark के अनुसार बनते हैं, और टेबल GitHub Flavored Markdown की पाइप सिंटैक्स में बनती हैं। GitHub, GitLab, Hugo, Jekyll और Docusaurus सभी इसे सही दिखाते हैं।
मर्ज की गई टेबल सेल का क्या होता है?
Markdown की पाइप टेबल में मर्ज किए गए सेल नहीं होते, इसलिए हर मर्ज किया हुआ हिस्सा अलग-अलग सेल में बँट जाता है और टेक्स्ट पहले सेल में रहता है। जटिल टेबल को .md के अंदर HTML में दोबारा बनाएँ, या कन्वर्ट करने से पहले Word में सरल कर लें।
मेरे Word डॉक्यूमेंट की फोटो कहाँ जाती हैं?
इमेज शामिल करें चालू होने पर हर तस्वीर ZIP में अलग फ़ाइल के रूप में सेव होती है, और Markdown उसे images/figure-1.png जैसे रिलेटिव पाथ से लिंक करता है। .md फ़ाइल कहीं और ले जाएँ तो वह फ़ोल्डर उसके बगल में ही रखें।
क्या Word के फ़ुटनोट Markdown में बने रहते हैं?
CommonMark में फ़ुटनोट की सिंटैक्स नहीं है, लेकिन GitHub ने 2021 में [^1] फ़ुटनोट जोड़े और ज़्यादातर साइट जनरेटर इन्हें सपोर्ट करते हैं। अगर आपका रेंडरर सपोर्ट नहीं करता, तो नोट का टेक्स्ट अंत में सामान्य पैराग्राफ़ के रूप में दिखता है।
क्या इस तरीके से Google Docs को Markdown में बदल सकते हैं?
हाँ। Google Docs में File > Download > Microsoft Word (.docx) चुनें, फिर वह फ़ाइल यहाँ अपलोड करें। Google Docs में Markdown डाउनलोड का अपना विकल्प भी है, जो सरल डॉक्यूमेंट के लिए अच्छा काम करता है।
