Word से Confluence Markdown: अपनी टीम विकि में दस्तावेज़ आयात करें

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

क्या Confluence Markdown का समर्थन करता है?

Confluence में आंशिक Markdown समर्थन है, लेकिन यह कार्यान्वयन-निर्भर है:

• __पी_ए__ बादल Markdown मैक्रो का समर्थन करता है और कुछ संदर्भों में Markdown को रेंडर कर सकता है, लेकिन मूल संपादक इसका अपना स्वरूप है
• Confluence डाटा सेंटर / सर्वर एक Markdown मैक्रो भी है
• एटलसियन रोवो / नया संपादक नए संस्करणों में Markdown पेस्ट समर्थन में सुधार हुआ है

सभी संस्करणों में सबसे विश्वसनीय विधि Word को Markdown में परिवर्तित करना है WordToMD, फिर Markdown सामग्री को Confluences Markdown आयात सुविधा का उपयोग करके चिपकाएं.

विधि 1: Markdown को Confluence संपादक के माध्यम से चिपकाएं

कदम

1. अपने Word दस्तावेज़ को परिवर्तित करें WordToMD और Copy Markdown पर क्लिक करें
2. Confluence में, पृष्ठ संपादक खोलें
3. सम्मिलित करें (+ आइकन) मेनू से, मार्कअप या अन्य मैक्रो → मार्कअप का चयन करें
4. भाषा के रूप में Markdown चुनें
5. Markdown सामग्री चिपकाएं
6. सम्मिलित करें पर क्लिक करें

मार्कअप/Markdown मैक्रो पृष्ठ के भीतर सामग्री को रिच टेक्स्ट के रूप में प्रस्तुत करता है. यह मूल Confluence ब्लॉक में परिवर्तित नहीं करता है, लेकिन यह शीर्षकों, तालिकाओं और सूचियों को सही तरीके से प्रस्तुत करता है.

विधि 2: Word फ़ाइल आयात

Confluence क्लाउड में Word आयात सुविधा है:

1. नया Confluence पृष्ठ बनाएँ
2. Word दस्तावेज़ आयात करने के लिए ... मेनू पर क्लिक करें
3. अपनी .docx फ़ाइल का चयन करें

यह सरल दस्तावेजों के लिए काम करता है लेकिन जटिल स्वरूपण को खो देता है। Markdown मार्ग अधिक नियंत्रण देता है।

विधि 3: HTML में परिवर्तित करें

कुछ टीमें HTML को मध्यवर्ती प्रारूप के रूप में पसंद करती हैं क्योंकि Confluences संपादक HTML पेस्ट को स्वीकार करता है:

1. अपने Word doc को Markdown में परिवर्तित करें WordToMD
2. Markdown को HTML में ऑनलाइन टूल का उपयोग करके परिवर्तित करें या marked library
3. Confluence स्रोत संपादक पर स्विच करें (Ctrl+Shift+D या टूलबार से)
4. HTML चिपकाएं

यह दृष्टिकोण अधिक जटिल स्वरूपण को संरक्षित करता है लेकिन अधिक चरणों में है।

स्वरूपण संगतता

हैंडलिंग टेबल

Word तालिकाओं को GFM पाइप वाक्यविन्यास के माध्यम से परिवर्तित करें WordToMD. Confluence’s Markdown macro renders these correctly:

| Project | Owner | Status |
|---|---|---|
| Website redesign | Alice | In progress |
| API migration | Bob | Complete |

अधिक जटिल तालिका संचालन के लिए, देखें Markdown तालिकाएँ: एक पूर्ण मार्गदर्शिका.

Confluence में कोड ब्लॉक

Confluence का अपना कोड ब्लॉक मैक्रो है जो वाक्यविन्यास हाइलाइटिंग और पंक्ति संख्या प्रदान करता है. Markdown सामग्री आयात करने के बाद, आप बेहतर पठनीयता के लिए मूल Confluence Code Block मैक्रो के साथ Markdown मैक्रो से कोड ब्लॉक को बदलना चाह सकते हैं:

1. पृष्ठ संपादित करें
2. कोड अनुभाग खोजें
3. कोड ब्लॉक मैक्रो सम्मिलित करें
4. वाक्यविन्यास हाइलाइटिंग के लिए भाषा सेट करें
5. कोड पेस्ट करें

संदर्भ: Markdown कोड ब्लॉक गाइड मानक वाक्यविन्यास के लिए।

एटलसियन __पी_ए__ और एडीएफ

Confluence क्लाउड मूल रूप से उपयोग करता है एटलसियन दस्तावेज़ प्रारूप (एडीएफ) समृद्ध सामग्री के लिए एक JSON स्कीमा। Markdown मैक्रो इसके ऊपर बैठता है. कार्यक्रमात्मक आयात के लिए, Confluence REST API सीधे ADF स्वीकार करता है। यदि आप एक स्वचालित पाइपलाइन बना रहे हैं, तो उपलब्ध पुस्तकालयों का उपयोग करके Word → Markdown → ADF को परिवर्तित करें.

अधिकांश टीमों के लिए, मैनुअल कार्यप्रवाह सरल और तेज़ है।

दस्तावेज़ पुस्तकालय में स्थानांतरण

यदि आप दर्जनों Word दस्तावेजों को Confluence में माइग्रेट कर रहे हैं:

1. सभी फ़ाइलों को परिवर्तित करें WordToMD (या बैच के साथ Pandoc बड़ी मात्रा के लिए)
2. एक Confluence स्थान बनाएँ और पृष्ठ पदानुक्रम की योजना बनाएं
3. अनुभागों में पृष्ठ आयात करें, मूल पृष्ठों के अंतर्गत संबंधित दस्तावेजों को समूहीकृत करें
4. आयात के बाद Confluence-विशिष्ट विशेषताएँ जोड़ें: लेबल, पृष्ठ प्रतिबंध, @mentions

FAQ

क्या मैक्रो के बिना Markdown का उपयोग Confluence में मूल रूप से किया जा सकता है? नए संपादक के साथ कन्फ्लुएंस क्लाउड के कुछ कॉन्फ़िगरेशन में, आप मार्कडाउन शॉर्टकट टाइप कर सकते हैं और वे ऑटो-कन्वर्ट (e.g., टाइपिंग) करते हैं। ## H2 उत्पन्न करता है। लेकिन परिवर्तित दस्तावेजों को चिपकाने के लिए, Markdown मैक्रो अधिक विश्वसनीय है.

मेरे शीर्षक स्वरूपण आयात के बाद खो गया है सब कुछ शरीर पाठ की तरह दिखता है. इसका मतलब है कि Markdown मैक्रो सक्रिय नहीं है. Markdown को मार्कअप/Markdown मैक्रो ब्लॉक के अंदर होना चाहिए, मानक संपादक में सादे पाठ के रूप में चिपकाया नहीं जाना चाहिए.

तालिकाएं कच्चे पाइप अक्षरों के रूप में दिखाई दे रही हैं। वही समस्या सामग्री Markdown मैक्रो के अंदर होनी चाहिए, मानक पाठ संपादक में नहीं.

क्या Word डॉक्स को Confluence पृष्ठों के साथ सिंक्रनाइज़ करने का कोई स्वचालित तरीका है? हाँ उपकरण जैसे Confluences बाहरी दस्तावेज़ सुविधा, स्क्रॉल संस्करण, या Confluence REST API का उपयोग करके कस्टम स्क्रिप्ट Markdown फ़ाइलों को पृष्ठों में स्वचालित रूप से सिंक्रनाइज़ कर सकते हैं.

निष्कर्ष

सबसे साफ __पी_बी__ से __पी_ए__ कार्यप्रवाह हैः के साथ परिवर्तित करें WordToMD, फिर Markdown मैक्रो के माध्यम से आयात करें. जटिल दस्तावेजों या थोक प्रवासों के लिए, HTML मध्यवर्ती दृष्टिकोण या REST API स्वचालन अधिक नियंत्रण देता है। किसी भी तरह से, रूपांतरण से पहले Words शीर्षक शैलियों का उचित उपयोग सुनिश्चित करता है कि पृष्ठ पदानुक्रम बरकरार रहे।