ডেভেলপাররা README সরবরাহ করছেন
ক্লায়েন্টকে সরবরাহযোগ্য, পিচ ডেক বা মুদ্রিত ডকুমেন্টেশনের জন্য একটি প্রজেক্টের README.md ফাইলকে PDF-এ রূপান্তর করুন — এতে সমস্ত কোড ব্লক, টেবিল এবং ফরম্যাটিং অক্ষুণ্ণ থাকবে, যা ফাইলটিকে GitHub-এ পাঠযোগ্য করে তোলে।
মার্কডাউন টেকনিক্যাল রাইটিংয়ের সাধারণ ভাষায় পরিণত হয়েছে। ডেভেলপাররা এটি README এবং RFC-এর জন্য ব্যবহার করেন, টেকনিক্যাল রাইটাররা ডকুমেন্টেশনের জন্য, শিক্ষাবিদরা পেপার ও নোটের জন্য এবং ডেটা সায়েন্টিস্টরা জুপিটার নোটবুক থেকে এটি এক্সপোর্ট করেন। কিন্তু মার্কডাউন একটি সোর্স ফরম্যাট, ডেলিভারি ফরম্যাট নয়। যখন আপনাকে কোনো ক্লায়েন্টের কাছে ডকুমেন্ট পাঠাতে, পেপার জমা দিতে, রানবুক আর্কাইভ করতে, বা এমন কারো সাথে রিপোর্ট শেয়ার করতে হয় যার কাছে মার্কডাউন ভিউয়ার নেই, তখন আপনার একটি পিডিএফ প্রয়োজন। চ্যালেঞ্জটি হলো প্যান্ডক ইনস্টল না করে, ল্যাটেক্স রেন্ডারার কনফিগার না করে, বা কমান্ড-লাইন পাইপলাইনের সাথে লড়াই না করে এটি করা।
LuraPDF-এর Markdown to PDF কনভার্টার একটি ব্রাউজার ট্যাবেই এই সমস্যার সমাধান করে। আপনার কন্টেন্ট পেস্ট করুন বা একটি ফাইল ড্রপ করুন, একটি লাইভ রেন্ডার করা প্রিভিউ দেখুন, একটি থিম বেছে নিন এবং একটি সম্পূর্ণ টাইপসেট করা PDF ডাউনলোড করুন — যাতে রয়েছে সিনট্যাক্স-হাইলাইট করা কোড ব্লক, রেন্ডার করা টেবিল, চেক করা টাস্ক লিস্ট, KaTeX ম্যাথ এবং Mermaid ডায়াগ্রাম। কোনো ইনস্টলেশন নেই, কোনো সার্ভার নেই, আপনার মেশিন থেকে কোনো ডেটা বাইরে যায় না। এটি একটি .md ফাইল থেকে শেয়ারযোগ্য PDF পাওয়ার দ্রুততম উপায়, যা দেখতে ঠিক তেমনই যেমনটা Markdown-এর হওয়ার কথা।
ওপেন-সোর্স ডেভেলপার থেকে শুরু করে শিক্ষাবিদ পর্যন্ত—যেখানেই কাঠামোগত সাধারণ টেক্সট লেখাকে একটি পরিমার্জিত ডেলিভারেবলে পরিণত করার প্রয়োজন হয়, সেখানেই মার্কডাউন-টু-পিডিএফ ওয়ার্কফ্লোটি বিভিন্ন ক্ষেত্রে ব্যবহৃত হয়।
ক্লায়েন্টকে সরবরাহযোগ্য, পিচ ডেক বা মুদ্রিত ডকুমেন্টেশনের জন্য একটি প্রজেক্টের README.md ফাইলকে PDF-এ রূপান্তর করুন — এতে সমস্ত কোড ব্লক, টেবিল এবং ফরম্যাটিং অক্ষুণ্ণ থাকবে, যা ফাইলটিকে GitHub-এ পাঠযোগ্য করে তোলে।
যেখানে একটি ওয়েব-ভিত্তিক ডক সাইট যথেষ্ট নয়, সেখানে অফলাইন বিতরণ, আনুষ্ঠানিক হস্তান্তর, বা কমপ্লায়েন্স প্যাকেজে অন্তর্ভুক্ত করার জন্য মার্কডাউন ডকুমেন্টেশন ফাইলগুলিকে PDF-এ এক্সপোর্ট করুন।
গবেষক এবং শিক্ষার্থীরা মার্কডাউনে ল্যাটেক্স গাণিতিক এক্সপ্রেশন ব্যবহার করে একটি সম্পূর্ণ ল্যাটেক্স এনভায়রনমেন্ট সেট আপ না করেই জমা দেওয়া বা পিয়ার রিভিউয়ের জন্য যথাযথভাবে টাইপসেট করা পিডিএফ তৈরি করতে পারেন।
রিপোর্ট ও প্রেজেন্টেশনের জন্য Jupyter বা Observable নোটবুক থেকে এক্সপোর্ট করা Markdown-কে PDF-এ রূপান্তর করুন — কোড সিনট্যাক্স, গাণিতিক সূত্র এবং Mermaid ভিজ্যুয়ালাইজেশন অক্ষুণ্ণ রেখে।
যেসব ছাত্রছাত্রী মার্কডাউন ব্যবহার করে লেকচার নোট, স্টাডি গাইড বা অ্যাসাইনমেন্টের উত্তর তৈরি করে, তারা ওয়ার্ড প্রসেসর ছাড়াই কয়েক সেকেন্ডের মধ্যে একটি ফরম্যাট করা পিডিএফ জমা দিতে পারে।
ওপেন-সোর্স রক্ষণাবেক্ষণকারীরা রিলিজ ডকুমেন্টেশন, অডিট ট্রেইল, অথবা এন্টারপ্রাইজ গ্রাহকদের কাছে পাঠানো আনুষ্ঠানিক রিলিজ প্যাকেজে অন্তর্ভুক্ত করার জন্য CHANGELOG.md ফাইলগুলোকে PDF-এ রূপান্তর করতে করতে পারেন।
Pandoc-এর মতো কমান্ড-লাইন টুল বা ব্রাউজারের প্রিন্ট-টু-পিডিএফ-এর তুলনায়, LuraPDF-এর কনভার্টার ডেভেলপার এবং টেকনিক্যাল রাইটারদের জন্য কিছু নির্দিষ্ট সুবিধা প্রদান করে:
আপনি যখন মার্কডাউন পেস্ট বা আপলোড করেন, তখন টুলটি একটি GFM-সম্মত পার্সার (markdown-it) দিয়ে সেটিকে পার্স করে, যা সমস্ত গিটহাব ফ্লেভার্ড মার্কডাউন এক্সটেনশন পরিচালনা করতে পারে। পেজ লেআউট পর্যায়ের আগে ম্যাথ ব্লকগুলো শনাক্ত করা হয় এবং KaTeX ব্যবহার করে HTML-এ প্রি-রেন্ডার করা হয়। মারমেইড ডায়াগ্রাম ব্লকগুলো Mermaid.js লাইব্রেরি ব্যবহার করে SVG-তে রেন্ডার করা হয়। নির্দিষ্ট ল্যাঙ্গুয়েজ গ্রামার ব্যবহার করে সিনট্যাক্স হাইলাইটিংয়ের জন্য কোড ফেন্সগুলোকে Prism-এর মধ্য দিয়ে পাঠানো হয়।
সম্পূর্ণ রেন্ডার করা HTML-কে এরপর pdf-lib এবং ক্যানভাস-ভিত্তিক রেন্ডারিং-এর সমন্বয়ে একটি PDF-এ রূপান্তর করা হয়। সমস্ত ফন্ট, সিনট্যাক্স কালার এবং ডায়াগ্রাম গ্রাফিক্স সরাসরি PDF বাইনারিতে এমবেড করা থাকে — আউটপুটটি স্বয়ংসম্পূর্ণ এবং সর্বত্র অভিন্নভাবে রেন্ডার হয়। সম্পূর্ণ পাইপলাইনটি আপনার ব্রাউজার ট্যাবে ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্ট হিসেবে চলে। আপনার মার্কডাউন কখনোই কোনো বাহ্যিক পরিষেবাতে পাঠানো হয় না।
| বৈশিষ্ট্য | লুরাপিডিএফ | md-to-pdf.fly.dev | ডিলিঞ্জার.আইও |
|---|---|---|---|
| সম্পূর্ণরূপে ব্রাউজার-ভিত্তিক (ব্যক্তিগত) | হ্যাঁ | না (সার্ভার-সাইড) | আংশিক |
| KaTeX গণিত রেন্ডারিং | হ্যাঁ | আংশিক | আংশিক |
| মারমেইড ডায়াগ্রাম সমর্থন | হ্যাঁ | না | না |
| ওয়াটারমার্ক ছাড়া বিনামূল্যে | হ্যাঁ | হ্যাঁ | হ্যাঁ |
মার্কডাউন লেখার কয়েকটি অভ্যাস উল্লেখযোগ্যভাবে উন্নত পিডিএফ আউটপুট তৈরি করবে:
আউটপুটে সঠিক সিনট্যাক্স হাইলাইটিং পেতে, কোড ফেন্স খোলার পর সর্বদা ভাষা উল্লেখ করুন — ` ``` ` এর পরিবর্তে ` ```javascript` ব্যবহার করুন।
স্ক্রিনে পড়ার জন্য ডকুমেন্টের ক্ষেত্রে গিটহাব লাইট থিম ব্যবহার করুন; কালি সাশ্রয়ের জন্য প্রিন্ট করার ক্ষেত্রে প্রিন্ট থিম ব্যবহার করুন।
ইনলাইন সমীকরণের জন্য গাণিতিক চিহ্নকে `$...$` এবং ডিসপ্লে-ব্লক সমীকরণের জন্য `$$...$$` এর মধ্যে রাখুন — KaTeX সিনট্যাক্সের ব্যাপারে বেশ কঠোর, তাই প্রথমে প্রিভিউতে পরীক্ষা করে নিন।
সেরা পিডিএফ রেন্ডারিংয়ের জন্য মারমেইড ডায়াগ্রামগুলো সরল রাখুন — জটিল ও বড় গ্রাফগুলো পৃষ্ঠায় ভালোভাবে মানিয়ে নাও যেতে পারে; প্রয়োজনে সেগুলোকে ভাগ করে নিন।
GFM টেবিলের কলামগুলোর মাঝে অবশ্যই ড্যাশ — `| --- |` — দিয়ে একটি বিভাজক সারি থাকতে হবে, নতুবা সেগুলো আউটপুটে টেবিল হিসেবে প্রদর্শিত হবে না।
এমবেড করা ছবির কারণে যদি তৈরি হওয়া PDF ফাইলটির আকার বড় হয়, তাহলে ইমেইলে শেয়ার করার জন্য ফাইলের আকার কমাতে পরে এটিকে Compress PDF টুলের মাধ্যমে চালান।
একটি .md ফাইল ড্রপ করুন অথবা আপনার মার্কডাউন পেস্ট করুন এবং একটি পরিচ্ছন্ন, সম্পূর্ণ রেন্ডার করা পিডিএফ ডাউনলোড করুন — এতে GFM, সিনট্যাক্স-হাইলাইট করা কোড, গাণিতিক হিসাব এবং ডায়াগ্রাম অন্তর্ভুক্ত রয়েছে। বিনামূল্যে, ব্যক্তিগত, কোনো ইনস্টলেশনের প্রয়োজন নেই।