Word to Markdown with Images: Extraction, Paths, and Alt Text

Word दस्तावेज़ में पाठ को Markdown में परिवर्तित करना सरल है। छवियों को परिवर्तित करना एक अलग कार्य है: Word मीडिया को स्टोर करता है .docx package, जबकि Markdown केवल एक छवि फ़ाइल के लिए एक पाठ संदर्भ संग्रहीत करता है.

विश्वसनीय कार्यप्रवाह दस्तावेज़ संरचना को परिवर्तित करना है, छवि फ़ाइलों को निकालना, उन्हें स्थिर नाम देना, और फिर प्रत्येक छवि को Markdown से एक सापेक्ष पथ और उपयोगी अल्ट टेक्स्ट के साथ कनेक्ट करें. यह गाइड दिखाता है कि कैसे संपत्ति का ट्रैक खोए बिना ऐसा किया जाए।

संक्षिप्त उत्तर

यदि आपके पास एक दस्तावेज़ और केवल कुछ चित्र हैं:

1. परिवर्तित करें .docx पाठ के साथ WordToMD.
2. Word फ़ाइल की प्रतिलिपि से छवियों को निकालें.
3. एक में छवियों डाल images/ or assets/ फ़ोल्डर।
4. Markdown संदर्भ जोड़ें जैसे ![Login settings screen](images/login-settings.png).
5. अपने गंतव्य में अंतिम Markdown का पूर्वावलोकन करें.

यदि आपके पास बहुत सारे दस्तावेज़ या बहुत सारी इमेज एम्बेडेड हैं, तो Pandoc with --extract-media. It can create the media files and references in one command, although you should still rename, optimize, and review the assets.

चित्र पाठ से क्यों भिन्न होते हैं

A .docx फ़ाइल एक ZIP पैकेज है जिसमें एक्सएमएल, संबंध, शैली और मीडिया शामिल हैं. एम्बेडेड इमेज बाइट्स आमतौर पर word/media/, जबकि संबंध फ़ाइलें बताती हैं Word जहां प्रत्येक छवि दिखाई देती है। दस्तावेज़ में कटाई के निर्देश, फ्लोटिंग पोजीशन, कैप्शन, सजावटी आकृतियां भी शामिल हो सकती हैं, और ऐसे लिंक जिनके पास प्रत्यक्ष Markdown समकक्ष नहीं हैं।

Markdown स्वयं छवि बाइट्स को एम्बेड नहीं करता है. मानक छवि वाक्यविन्यास में तीन सूचनाएं होती हैं:

![Alternative text](images/architecture-diagram.png "Optional title")

• Alternative text छवि का वर्णन करता है जब इसे नहीं देखा जा सकता है।
• images/architecture-diagram.png रेंडरर को बताता है कि फाइल कहाँ रहती है.
• रेंडरर के आधार पर वैकल्पिक शीर्षक टूलटिप के रूप में दिखाई दे सकता है.

यह विभाजन संस्करण नियंत्रण और प्रकाशन के लिए उपयोगी है, लेकिन इसका मतलब है कि एक पूर्ण माइग्रेशन दोनों को प्रबंधित करना चाहिए .md फाइल और उसकी संपत्तियां।

एम्बेडेड छवियों के साथ WordToMD क्या करता है

WordToMD आपके ब्राउज़र में शीर्षकों, पैराग्राफ, सूचियों, लिंक, जोर, बुनियादी तालिकाओं, और समर्थित एम्बेडेड चित्रों को परिवर्तित करता है. जब चित्र मिलते हैं, तो परिणाम में एक __पी_ए__ + छवियाँ __पी_बी__ विकल्प जिसमें .md फ़ाइल और एक images/ फ़ोल्डर।

आपका दस्तावेज़ स्थानीय रहता है, और उत्पन्न Markdown छवि संदर्भ पैकेज में सापेक्ष पथ का उपयोग images/ फ़ोल्डर। ऑल्ट टेक्स्ट की समीक्षा करें, सामान्य परिसंपत्तियों का नाम बदलें, और प्रकाशित करने से पहले जटिल Word ड्राइंग ऑब्जेक्ट की जांच करें.

सही निकासी विधि चुनें

कार्यप्रवाह A: WordToMD प्लस मैनुअल इमेज एक्सट्रैक्शन

यह विधि आपको संपत्ति के नाम और स्थान पर नियंत्रण देते हुए पाठ रूपांतरण को तेज़ रखती है।

१. Markdown को परिवर्तित और सहेजें

खोलें Word-to-Markdown कनवर्टर, चुनें .docx, संपादन योग्य परिणाम की समीक्षा करें, और डाउनलोड करें .md फाइल। माइग्रेशन पूरा होने तक मूल Word दस्तावेज़ को अपरिवर्तित रखें.

२. DOCX की प्रतिलिपि से चित्र निकालें

एक्सटेंशन बदलने से पहले एक प्रतिलिपि बनाओ।

विंडोज पर:

1. सक्षम करें फ़ाइल नाम एक्सटेंशन फ़ाइल एक्सप्लोरर में।
2. कॉपी handbook.docx कार्यरत फ़ोल्डर में।
3. प्रतिलिपि का नाम बदलकर handbook.zip.
4. ZIP अभिलेखागार निकालें.
5. निकाले गए को खोलें word/media/ फ़ोल्डर।

मैकओएस या लिनक्स पर, एक सामान्य अभिलेखागार उपयोगिता को खोलने के लिए कॉपी किया जा सकता है .docx सीधे, या आप फ़ाइल को डुप्लिकेट कर सकते हैं और इसके एक्सटेंशन को बदल सकते हैं .zip.

मीडिया निर्देशिका में PNG, JPEG, GIF, SVG, EMF, या WMF फाइलें हो सकती हैं. कुछ प्रकाशन प्रणाली Word-विशिष्ट वेक्टर प्रारूपों को संभालती नहीं है, इसलिए Markdown परियोजना में जोड़ने से पहले असमर्थित प्रारूपों को SVG या PNG में परिवर्तित करें.

3. प्रत्येक फ़ाइल को उसके स्थान से मेल करें

जैसे नाम image1.png and image2.jpeg पैकेज पहचानकर्ता हैं, सार्थक संपत्ति नाम नहीं। निकाली गई फ़ाइलों को थंबनेल के रूप में खोलें और उन्हें Word दस्तावेज़ के साथ तुलना करें.

काम करते समय एक सरल मानचित्रण बनाएं:

यह मत मानिए कि संख्यात्मक क्रम हमेशा दृश्य क्रम से मेल खाता है। हेडर, दोहराए गए लोगो, पृष्ठभूमि, और हटाई गई सामग्री आंतरिक नंबरिंग को प्रभावित कर सकती हैं.

४. एक पोर्टेबल फ़ोल्डर संरचना बनाएं

एक सरल संरचना GitHub, Obsidian, और अधिकांश स्थिर-साइट जनरेटर पर काम करती हैः

handbook/
├── handbook.md
└── images/
    ├── system-architecture.png
    ├── login-settings.jpg
    └── conversion-result.png

फिर सापेक्ष पथों के साथ फ़ाइलों का संदर्भ लें:

![System architecture](images/system-architecture.png)

सापेक्ष पथ दस्तावेज़ को पोर्टेबल रखते हैं. एक पूर्ण मार्ग जैसे C:\Users\Name\Desktop\image1.png केवल एक कंप्यूटर पर काम करता है और प्रकाशित Markdown में कभी भी दिखाई नहीं देना चाहिए।

५. सार्थक वैकल्पिक पाठ लिखें

Word छवि कैप्शन और Markdown अल्ट टेक्स्ट अलग-अलग उद्देश्यों की सेवा करते हैं. एक कैप्शन दृश्य समर्थन पाठ है; अल्ट टेक्स्ट छवि द्वारा प्रेषित जानकारी के लिए एक संक्षिप्त प्रतिस्थापन है।

कमजोर:

![Image](images/image1.png)

बेहतर:

![Three-stage publishing flow from Word review to Markdown repository to website deployment](images/publishing-flow.png)

स्क्रीनशॉट के लिए, प्रासंगिक इंटरफ़ेस और राज्य की पहचान करें. चार्ट के लिए, प्रत्येक दृश्य चिह्न की सूची देने के बजाय निष्कर्ष का सारांश दें। ऐसी सजावटी छवि के लिए जिसमें कोई जानकारी न हो, खाली अल्ट टेक्स्ट का उपयोग करें:

![](images/decorative-divider.svg)

word के लिए आस-पास के कैप्शन word को दोहराएं नहीं जब तक कि यह सबसे स्पष्ट समकक्ष विवरण न हो।

६. वास्तविक गंतव्य में पूर्वावलोकन

Markdown रेंडरर भिन्न होते हैं. एक पथ जो स्थानीय संपादक में काम करता है, तैनाती के बाद विफल हो सकता है यदिः

• अभिलेखागार बड़े अक्षरों के लिए संवेदनशील फ़ाइल नामों का उपयोग करता है;
• साइट परिसंपत्ति URL को फिर से लिखती है;
• Markdown फ़ाइल किसी अन्य निर्देशिका में स्थानांतरित हो जाती है;
• रिक्त स्थान या गैर-एएससीआईआई वर्णों के साथ अलग-अलग तरीके से व्यवहार किया जाता है;
• प्लेटफ़ॉर्म एक फ़ाइल प्रारूप को अवरुद्ध करता है।

GitHub पर अंतिम पृष्ठ का पूर्वावलोकन करें, Obsidian में, या साइट की सामान्य निर्माण प्रक्रिया के माध्यम से। डेस्कटॉप और मोबाइल चौड़ाई पर हर छवि की जाँच करें.

कार्यप्रवाह बी: Pandoc के साथ छवियाँ निकालें

Pandoc एक बेहतर फिट है जब छवि मानचित्रण अन्यथा प्रवासन पर हावी होगा।

pandoc handbook.docx \
  -t gfm \
  --wrap=none \
  --extract-media=./assets \
  -o handbook.md

Pandoc एम्बेडेड मीडिया निकालता है और उत्पन्न Markdown में संदर्भ लिखता है. प्रकाशित करने से पहले परिणामी निर्देशिका की जांच करें: उत्पन्न पदानुक्रम और नाम तकनीकी रूप से सही हो सकते हैं लेकिन बनाए रखना मुश्किल हो सकता है।

रूपांतरण के बाद:

1. दोहराने वाली या अप्रयुक्त संपत्तियों को हटा दें।
2. वर्णनात्मक, छोटे अक्षरों के नामों के साथ फ़ाइलों का नाम बदलें.
3. नाम बदलने के बाद प्रत्येक Markdown संदर्भ को अद्यतन करें.
4. असमर्थित स्वरूपों को परिवर्तित करें.
5. वैकल्पिक पाठ जोड़ें या सुधारें.
6. बड़ी फ़ाइलें संपीड़ित करें।

बार-बार रूपांतरण के लिए, देखें बैच Word-to-Markdown गाइड.

सामान्य गंतव्यों के लिए चित्र पथ

GitHub

Markdown फ़ाइल के सापेक्ष भंडार में छवियों को संग्रहीत करें और पथों का उपयोग करें:

![Build status screen](docs/images/build-status.png)

फाइल-नाम मामला मायने रखता है। Build-Status.png and build-status.png अलग-अलग फ़ाइलों की तरह व्यवहार कर सकते हैं जब रिपॉजिटरी एक केस-संवेदनशील प्रणाली पर प्रस्तुत की जाती है। द Word-to-GitHub गाइड शेष GFM सफाई को कवर करता है।

Obsidian

मानक Markdown छवि वाक्यविन्यास सबसे अधिक पोर्टेबल विकल्प है:

![Research model](attachments/research-model.png)

Obsidian विकी-शैली के एम्बेड का भी समर्थन करता है, लेकिन वे एप्लिकेशन-विशिष्ट हैं. प्रत्येक संदर्भ को परिवर्तित करने से पहले यह तय करें कि पोर्टेबिलिटी या Obsidian-नेटिव व्यवहार अधिक मायने रखता है या नहीं। देखें Word-to-Obsidian कार्यप्रवाह.

स्थैतिक-साइट जनरेटर

साइटें वर्तमान Markdown फ़ाइल के संबंध में परिसंपत्तियों को हल कर सकती हैं, a public/ निर्देशिका, या आयात पाइपलाइन। छवियों को स्थानांतरित करने से पहले परियोजना के सम्मेलन की पुष्टि करें. एक पथ जैसे कि /images/guide/example.png एक साइट पर काम कर सकता है, लेकिन जब साइट को एक उपनिर्देशिका के तहत तैनात किया जाता है तो टूट जाता है।

पढ़ें Word-स्थिर-साइट गाइड और उत्पादन बिल्ड कमांड के माध्यम से परीक्षण।

प्रकाशन से पहले संसाधनों का अनुकूलन करें

Word दस्तावेजों में अक्सर ऐसी छवियां होती हैं जो उनके प्रदर्शित आकार से बहुत बड़ी होती हैं. उन मूल प्रकाशनों को प्रकाशित करने से दृश्य गुणवत्ता में सुधार किए बिना पृष्ठ लोड धीमा हो सकता है।

इन व्यावहारिक नियमों का प्रयोग करें:

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

प्रत्येक छवि को स्वचालित रूप से एक प्रारूप में परिवर्तित करने से बचें। स्क्रीनशॉट, आरेख, फोटो और पारदर्शी चित्रों की अलग-अलग आवश्यकताएं होती हैं।

आम छवि समस्याएं और समाधान

Markdown एक टूटी हुई छवि आइकन दिखाता है

पथ के सापेक्ष की जाँच करें .md फ़ाइल, जिसमें पूंजीकरण और विस्तार शामिल है। फिर पुष्टि करें कि परिसंपत्ति प्रतिबद्ध है, अपलोड किया गया है, या तैनाती आउटपुट में कॉपी किया गया है।

छवि स्थानीय रूप से काम करती है लेकिन ऑनलाइन नहीं

स्थानीय पथ परियोजना के बाहर इंगित कर सकता है, या तैनात साइट एक अलग आधार यूआरएल का उपयोग कर सकती है. मशीन-विशिष्ट पथों को रिपॉजिटरी-संबंधी या साइट-अनुमोदित पथों से बदलें।

निकाली हुई छवि Word से भिन्न दिखती है

Word कटाई, घूर्णन, पारदर्शिता, सीमाओं को लागू कर सकते हैं, या मूल छवि को बदलने के बजाय दस्तावेज़ निर्देशों के रूप में रंग समायोजन। एक छवि संपादक में अंतिम रूप को फिर से बनाएं और प्रकाशन-तैयार परिसंपत्ति निर्यात करें.

एक आरेख गायब है

स्मार्टआर्ट, चार्ट, समूहीकृत आकृति, और ड्राइंग कैनवास हमेशा साधारण रास्टर छवियों के रूप में संग्रहीत नहीं होते हैं। Word से ऑब्जेक्ट को SVG या PNG के रूप में निर्यात करें, फिर उस निर्यात की गई फ़ाइल को मैन्युअल रूप से संदर्भित करें.

फ़ाइल का नाम बदल गया लेकिन छवि गायब हो गई

किसी परिसंपत्ति का नाम बदलना Markdown को स्वचालित रूप से अपडेट नहीं करता है. पुराने नाम के लिए परियोजना में खोजें और संदर्भ-शैली छवि परिभाषाओं सहित प्रत्येक संदर्भ को अद्यतन करें.

अंतिम छवि माइग्रेशन चेकलिस्ट

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

FAQ

क्या WordToMD मेरे DOCX के अंदर की छवियों को डाउनलोड कर सकता है?

हाँ, हाँ। DOCX को परिवर्तित करें और चुनें __पी_ए__ + छवियाँ __पी_बी__. The archive contains the editable Markdown and supported embedded pictures in an images/ फ़ोल्डर। आप अलग Word Image Extractor का भी उपयोग कर सकते हैं जब आपको केवल मूल मीडिया फ़ाइलों की आवश्यकता होती है.

Markdown में एक छवि संग्रहीत कर सकते हैं .md फाइल?

मानक Markdown एक संदर्भ संग्रहीत करता है, बाइनरी छवि नहीं। कुछ संपादक base64 डेटा URL को स्वीकार करते हैं, लेकिन वे Markdown फ़ाइलों को बड़ा और कम पोर्टेबल बनाते हैं. एक सापेक्ष पथ के साथ एक अलग परिसंपत्ति फ़ाइल को बनाए रखना आमतौर पर आसान होता है।

क्या मुझे एक पूर्ण URL या एक सापेक्ष छवि पथ का उपयोग करना चाहिए?

एक सापेक्ष पथ का उपयोग करें जब छवि एक ही रिपॉजिटरी या साइट से संबंधित हो. केवल तब ही एक पूर्ण HTTPS URL का उपयोग करें जब छवि को जानबूझकर कहीं और होस्ट किया गया हो और बनाए रखा गया हो। उन URL से बचें जिन पर आपका नियंत्रण नहीं है.

मुझे Word कैप्शन को कैसे संभालना चाहिए?

कैप्शन को छवि के पास दृश्यमान पाठ के रूप में रखें और छवि के अर्थ के लिए अलग अल्ट टेक्स्ट लिखें। यदि आपके प्रकाशन प्रणाली में एक आकृति या कैप्शन घटक है, तो उस जोड़ी को उस प्लेटफ़ॉर्म के समर्थित वाक्यविन्यास में परिवर्तित करें.

निष्कर्ष

एक सफल Word-to-Markdown छवि माइग्रेशन Markdown और उसकी संपत्तियों को एक पैकेज के रूप में व्यवहार करता है। उपयोग WordToMD त्वरित, निजी पाठ रूपांतरण के लिए, मीडिया को अलग से निकालें, जानबूझकर नाम और पथ बनाएं, और परिणाम का पूर्वावलोकन करें जहां यह वास्तव में प्रकाशित किया जाएगा। बड़े या दोहराए जाने वाले प्रवासों के लिए, Pandoc पर स्विच करें और अंतिम अभिगम्यता और पथ समीक्षा को छोड़ने के बिना निष्कर्षण चरण को स्वचालित करें.