Word से Markdown स्वरूपण गाइड: हर शैली को संरक्षित करें

प्रारूपण वह स्थान है जहाँ अधिकांश Word-to-Markdown रूपांतरण गलत हो जाते हैं. बोल्ड पाठ सादे पाठ के रूप में दिखाई देता है. टेबल गिर जाते हैं। शीर्षक अनुच्छेदों में बदल जाते हैं। यह गाइड स्पष्ट करता है कि इस दौरान क्या होता है Word से Markdown रूपांतरण और आउटपुट को कैसे नियंत्रित किया जाए।

रूपांतरण पाइपलाइन को समझना

जब आप Word दस्तावेज़ को Markdown में परिवर्तित करते हैं, तो दो चीजें होती हैं:

1. __पी_ए__ → __पी_बी__ mammoth.js Word XML को पार्स करता है और प्रत्येक तत्व को HTML में मैप करता है
2. __पी_बी__ → __पी_ए__ टर्नडाउन HTML को Markdown वाक्यविन्यास में परिवर्तित करता है

दूसरा चरण हानि रहित है यदि HTML साफ है। पहला कदम है जहां स्वरूपण जटिलता मायने रखता है Words शैलियों को ज्ञात HTML समकक्षों को मैप करने की आवश्यकता है।

उपयोग WordToMDs कनवर्टर यह देखने के लिए कि आपका दस्तावेज़ वास्तविक समय में कैसे परिवर्तित होता है।

शीर्षक शैली

Word में सबसे महत्वपूर्ण स्वरूपण निर्णय अंतर्निहित शीर्षक शैलियों का उपयोग कर रहा है.

आम गलती: शीर्षक शैली लागू करने के बजाय पाठ को बड़े और बोल्ड के रूप में मैन्युअल रूप से स्वरूपित करना। यह Word में शीर्षक की तरह दिखता है लेकिन Markdown में बोल्ड टेक्स्ट में परिवर्तित होता है, नहीं ##.

पूर्ण शीर्षक संदर्भ के लिए, देखें Markdown शीर्षक गाइड.

पाठ का महत्व

रेखांकित और हाइलाइट मानक वाक्यविन्यास में कोई Markdown समकक्ष नहीं है. रूपांतरण के बाद, HTML का प्रयोग करें <u> टैग या कस्टम सीएसएस कक्षाएं यदि आपका प्रकाशन मंच उनका समर्थन करता है।

सूचियाँ

Word का स्वचालित सूची स्वरूपण शुद्ध रूप से परिवर्तित करता हैः

- Bullet item one
- Bullet item two
  - Nested bullet (indent 2 spaces)

1. First item
2. Second item
   1. Nested numbered item

जो सूची को तोड़ता है: मैन्युअल रूप से टाइप किए गए डैश या संख्याएँ जो वास्तविक Word सूची आइटम नहीं हैं. ये सूचियों की तरह दिखते हैं लेकिन Word उन्हें सादे पाठ पैराग्राफ के रूप में व्यवहार करता है. सुधारः उन्हें Word में चुनें और सूची बुलेट या सूची संख्या शैली लागू करें.

तालिकाएँ

मानक तालिकाओं में परिवर्तित करें GitHub स्वादित Markdown तालिका वाक्यविन्यासः

| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |

जो तालिकाओं को तोड़ता है:

• विलयित कक्ष कई स्तंभों या पंक्तियों को कवर करने वाली कक्ष एक साथ गिर जाएगी
• बहु-पंक्ति कोशिका सामग्री कोशिकाओं के अंदर लाइन टूट जाती है
• नेस्टेड टेबल आंतरिक टेबल सादे पाठ के लिए समतल है

पूर्ण विघटन के लिए, देखें Markdown तालिकाएँ: एक पूर्ण मार्गदर्शिका.

कोड और पूर्व स्वरूपित पाठ

इनलाइन कोड में Word मैप्स में एक मोनोस्पेस फ़ॉन्ट (Courier New, Consolas) के साथ स्वरूपित पाठ:

Use `console.log()` to debug.

वाक्यविन्यास हाइलाइटिंग वाले बाड़ लगाए गए कोड ब्लॉक के लिए, Words Code पैराग्राफ शैली लागू करें यदि आपके टेम्पलेट में एक है, या रूपांतरण के बाद तीन बार बैकटिक बाड़ जोड़ें। देखें Markdown कोड ब्लॉक गाइड पूर्ण वाक्यविन्यास के लिए।

हाइपरलिंक

Word हाइपरलिंक्स पूरी तरह से परिवर्तित:

Visit [WordToMD](https://wordtomd.org) for instant conversion.

लिंक पाठ और यूआरएल दोनों संरक्षित हैं. बुकमार्क (एक ही दस्तावेज़ के भीतर आंतरिक लिंक) परिवर्तित नहीं हो सकता है यदि लक्ष्य Markdown में मौजूद नहीं है.

चित्र

छवि वह जगह है जहाँ Word-to-Markdown रूपांतरण लगातार कम होता है. mammoth.js एम्बेडेड छवियों को base64 डेटा यूआरआई के रूप में निकाल सकता है, लेकिन डिफ़ॉल्ट व्यवहार रूपांतरण नोट्स में उनकी उपस्थिति को नोट करना है। रूपांतरण के बाद:

1. Word से चित्र निर्यात करें: फ़ाइल → सहेजें के रूप में → वेब पेज (HTML)
2. इनका संदर्भ Markdown में दें: ![Alt text](path/to/image.png)

विशेष वर्ण और प्रतीक

Word अक्सर विशेष यूनिकोड वर्णों को स्वचालित रूप से सम्मिलित करता है:

• स्मार्ट कोटेशन ("...") → यूनिकोड वर्णों के रूप में संरक्षित
• एम डैश (—) → संरक्षित
• गैर-ब्रेकिंग स्पेस → नियमित स्पेस में परिवर्तित
• कॉपीराइट प्रतीक (©) → संरक्षित

यदि आपको केवल ASCII-आउटपुट की आवश्यकता है, तो रूपांतरण के बाद अपने पाठ संपादक में एक खोज-और-प्रतिस्थापन करें.

कस्टम Word शैलियों

यदि आपका वर्ड दस्तावेज़ कस्टम पैराग्राफ शैलियों (जैसे Callout या Warning) का उपयोग करता है, तो mammoth.js उन्हें रूपांतरण नोट्स के रूप में लॉग करता है. आपको Unrecognized paragraph style जैसे संदेश दिखाई देंगे: Callout. WordToMD इन सूचनात्मक संदेशों को डिफ़ॉल्ट रूप से फ़िल्टर करता है.

कस्टम शैलियों को संभालने के लिए, आपको एक कस्टम फ़िल्टर के साथ स्थानीय Pandoc सेटअप की आवश्यकता होगी __पी_बी__ __पी_सी__ से __पी_ए__ इस दृष्टिकोण के लिए।

कन्वर्ट करने से पहले चेकलिस्ट को फॉर्मेट करना

परिवर्तित करने से पहले इस चेकलिस्ट को अपने Word दस्तावेज़ पर लागू करें:

• सभी शीर्षक Words अंतर्निहित शीर्षक 1/2/3 शैलियों का उपयोग करते हैं (मैनुअल स्वरूपण नहीं)
• सूचियाँ Words सूची औजारों के साथ बनाई जाती हैं (टिप किए गए डैश/संख्याएँ नहीं)
• तालिकाएँ सरल ग्रिड हैं (कोई विलयित कक्ष नहीं)
• कोड एक मोनोस्पेस फ़ॉन्ट का उपयोग करता है
• हाइपरलिंक्स वास्तविक हाइपरलिंक्स हैं (केवल नीले रेखांकित पाठ नहीं)

FAQ

मेरे शीर्षक बोल्ड टेक्स्ट में क्यों परिवर्तित हो रहे हैं? आपने हेडिंग शैली के बजाय मैनुअल बोल्ड + फ़ॉन्ट आकार स्वरूपण लागू किया है. Word में, पैराग्राफ पर क्लिक करें और स्टाइल पैनल को देखें यह कहना चाहिए शीर्षक 1 नहीं सामान्य.

मेरी नंबर वाली सूची गलत जगह पर 1 पर फिर से शुरू हुई मैं इसे कैसे ठीक करूं? Word में सूची निरंतरता सेट करें: सूची पर राइट-क्लिक करें → नंबर जारी रखें. या रूपांतरण के बाद सीधे Markdown को संपादित करें.

Markdown में तालिका संरेखण गलत दिखता है. क्या हुआ था? GFM तालिकाओं का उपयोग |---| संरेखण विभाजकों के लिए। WordToMD इन्हें स्वचालित रूप से उत्पन्न करता है. यदि प्रतिपादन गलत दिखता है, तो जांचें कि किसी भी कोशिका में पाइप वर्ण नहीं हैं (|) उनकी सामग्री में उनसे बचने के रूप में \|.

निष्कर्ष

साफ हो रहा है Word से Markdown स्वरूपण मुख्य रूप से Word का सही तरीके से उपयोग करने के बारे में है। अंतर्निहित शीर्षक शैलियों को लागू करें, Words सूची और तालिका उपकरण का उपयोग करें, और आपको लगभग सही आउटपुट मिलेगा WordToMD कनवर्टर. For edge cases — custom styles, complex tables, images — the tips above will get you the rest of the way there.