Markdown سے Word اور HTML میں تبدیلی کا عمل
Markdown ایک سادہ اور ٹیکسٹ پر مبنی فارمیٹ ہے جو تحریر کو منظم کرنے کے لیے استعمال کیا جاتا ہے۔ جب اس سادہ ٹیکسٹ کو دفتری دستاویزات یا ویب صفحات کے لیے استعمال کرنا ہو، تو اسے Microsoft Word (.docx) یا HTML فارمیٹ میں تبدیل کرنے کی ضرورت پیش آتی ہے۔ یہ کنورٹر آپ کو اپنے براؤزر میں ہی Markdown لکھنے، اس کا لائیو پریویو دیکھنے اور اسے مطلوبہ فارمیٹ میں ایکسپورٹ کرنے کی سہولت دیتا ہے۔
جب آپ اس ٹول میں Markdown لکھتے ہیں، تو یہ فوری طور پر اس کا فارمیٹ شدہ پریویو اور خام HTML کوڈ تیار کرتا ہے۔ اس کے ساتھ ساتھ یہ تحریر کے الفاظ اور حروف کی تعداد بھی ظاہر کرتا ہے۔ یہ عمل ان مصنفین کے لیے کارآمد ہے جنہیں README فائلیں، ہدایات، نوٹس یا مضامین DOCX اور HTML فارمیٹ میں فراہم کرنے ہوتے ہیں۔
ان پٹ اور آؤٹ پٹ کی تفصیلات
اس ٹول کا استعمال انتہائی سادہ ہے اور یہ درج ذیل ان پٹ اور آؤٹ پٹ پیرامیٹرز پر کام کرتا ہے:
ان پٹ (Inputs)
- Markdown ٹیکسٹ: آپ ایڈیٹر میں اپنا Markdown ٹیکسٹ لکھ سکتے ہیں یا کہیں سے کاپی کر کے پیسٹ کر سکتے ہیں۔ یہ ٹول عام Markdown ڈھانچے جیسے سرخیاں (Headings)، فہرستیں (Lists)، جدول (Tables)، لنکس (Links)، کوڈ بلاکس (Code blocks)، نمایاں ٹیکسٹ (Emphasis) اور ٹاسک لسٹس (Task lists) کو قبول کرتا ہے۔
- حروف کی حد: مقامی طور پر Word ایکسپورٹ کرنے کے لیے ان پٹ ٹیکسٹ کے حروف کی ایک حد مقرر ہے۔ اگر ٹیکسٹ اس حد سے تجاوز کر جائے تو سسٹم فائل ایکسپورٹ کرنے سے روک دیتا ہے۔
آؤٹ پٹ (Outputs)
- پریویو: آپ کے Markdown کا فوری فارمیٹ شدہ پریویو۔
- HTML: آپ کے Markdown سے تیار کردہ خام HTML کوڈ۔
- Word ڈاؤن لوڈ کریں: آپ کے مواد پر مشتمل ایک.docx فائل۔
- HTML ڈاؤن لوڈ کریں: ایک خود مختار.html فائل۔
- HTML کاپی کریں: تیار کردہ HTML کوڈ کو کلپ بورڈ پر کاپی کرنے کی سہولت۔
- الفاظ اور حروف کی تعداد: ان پٹ ایریا کے نیچے "الفاظ" اور "حروف" کی لائیو تعداد ظاہر ہوتی ہے۔
تبدیلی کے تکنیکی قوانین اور حدود
دستاویز کی تبدیلی کے دوران یہ ٹول مخصوص تکنیکی قوانین پر عمل کرتا ہے تاکہ آؤٹ پٹ درست رہے:
- فائل کا نام: ایکسپورٹ کی جانے والی Word دستاویز کا نام خودکار طور پر آپ کے Markdown میں موجود پہلی H1 سرخی (# Heading) سے اخذ کیا جاتا ہے۔
- خام HTML کی فلٹرنگ: رینڈرنگ سے پہلے آپ کے Markdown کے اندر موجود خام HTML کو ایسکیپ (escape) کر دیا جاتا ہے تاکہ سیکیورٹی برقرار رہے اور ڈاؤن لوڈ کردہ HTML ایک سادہ خود مختار دستاویز کے طور پر حاصل ہو۔
- لنکس کی سیکیورٹی: پریویو اور HTML آؤٹ پٹ میں شامل تمام لنکس میں خودکار طور پر
noopener noreferrerکا اضافہ کیا جاتا ہے تاکہ بیرونی ویب سائٹس پر ریفرر کی معلومات منتقل نہ ہوں۔ - خالی ایڈیٹر کا رویہ: اگر ان پٹ ایریا خالی ہو تو پریویو کی جگہ "آپ کا فارمیٹ شدہ پریویو اور HTML یہاں ظاہر ہوں گے۔" کا پیغام نظر آتا ہے۔
- ایڈیٹر کی صفائی: جب ایڈیٹر کو صاف کیا جاتا ہے تو اسٹیٹس تبدیل ہو کر "ایڈیٹر صاف کر دیا گیا۔" ہو جاتا ہے اور حروف کی تعداد 0 پر ری سیٹ ہو جاتی ہے۔
خرابیوں کے پیغامات (Error Messages)
تبدیلی یا ایکسپورٹ کے عمل میں کسی رکاوٹ کی صورت میں سسٹم درج ذیل مخصوص پیغامات ظاہر کرتا ہے:
- اگر ایڈیٹر میں کچھ لکھے بغیر ایکسپورٹ کرنے کی کوشش کی جائے تو یہ پیغام ظاہر ہوتا ہے: "ایکسپورٹ کرنے کے لیے کچھ نہیں ہے — پہلے کچھ Markdown لکھیں۔"
- اگر آپ کا Markdown ٹیکسٹ مقامی Word ایکسپورٹ کی حد سے زیادہ بڑا ہو جائے تو یہ پیغام نظر آتا ہے: "یہ Markdown مقامی Word ایکسپورٹ کے لیے بہت بڑا ہے۔ اسے
{max}حروف سے کم رکھیں۔" - اگر کسی تکنیکی وجہ سے فائل کی تبدیلی ناکام ہو جائے تو سسٹم یہ پیغام دکھاتا ہے: "تبدیلی ناکام ہو گئی۔ چھوٹی Markdown دستاویز آزمائیں۔"
ڈیٹا کی رازداری اور پروسیسنگ کا طریقہ کار
اس ٹول میں آپ کی تحریر کی رازداری کو ترجیح دی جاتی ہے۔ آپ کا Markdown مکمل طور پر آپ کے براؤزر میں ہی پروسیس ہوتا ہے اور BroBroGo پر کچھ بھی اپ لوڈ نہیں کیا جاتا۔ پریویو تیار کرنا، HTML ایکسپورٹ کرنا اور Word دستاویز (.docx) بنانا، یہ تمام مراحل مقامی طور پر آپ کے کمپیوٹر یا موبائل کے براؤزر کے اندر ہی انجام پاتے ہیں۔ اس کا مطلب ہے کہ آپ کا حساس ڈیٹا کسی بیرونی سرور پر منتقل نہیں ہوتا۔
اکثر پوچھے گئے سوالات (FAQ)
کیا میرا Markdown اپ لوڈ کیا جاتا ہے؟
نہیں۔ پریویو، HTML ایکسپورٹ، اور Word دستاویز کی تیاری سب کچھ مقامی طور پر آپ کے براؤزر میں ہی چلتا ہے۔
Word ایکسپورٹ میں کیا کچھ برقرار رہتا ہے؟
DOCX فائل عام Markdown ڈھانچے جیسے سرخیاں، فہرستیں، جدول، لنکس، کوڈ بلاکس، نمایاں ٹیکسٹ اور ٹاسک لسٹس کو برقرار رکھتی ہے۔
کیا HTML ایکسپورٹ میں غیر محفوظ اسکرپٹس شامل ہوتی ہیں؟
نہیں۔ رینڈرنگ سے پہلے آپ کے Markdown کے اندر موجود خام HTML کو ایسکیپ (escape) کر دیا جاتا ہے، اور ڈاؤن لوڈ کردہ HTML ایک سادہ خود مختار دستاویز ہوتی ہے۔
اگر میری دستاویز بہت بڑی ہو تو کیا ہوگا؟
اگر Markdown ٹیکسٹ مقامی Word ایکسپورٹ کی حد سے تجاوز کر جائے تو سسٹم "یہ Markdown مقامی Word ایکسپورٹ کے لیے بہت بڑا ہے۔ اسے {max} حروف سے کم رکھیں۔" کا پیغام دکھائے گا۔ ایسی صورت میں آپ کو تحریر کا سائز کم کرنا ہوگا۔