Markdown থেকে PDF করুন

README, নোট বা ডকুমেন্টেশন থেকে সুন্দর টাইপসেট করা PDF বানান — GitHub-এর মতো টেবিল, হাইলাইট করা কোড, ফুটনোট আর ক্লিকযোগ্য সূচিপত্রসহ — এবং এডিট করতে করতেই দেখুন ঠিক কেমন দেখাবে।

কনভার্টের সঙ্গে সঙ্গেই মুছে ফেলা হয়
এনক্রিপ্ট করে পাঠানো, সঙ্গে সঙ্গে মুছে ফেলা
সাইনআপ নেই, ওয়াটারমার্ক নেই

হাতের কাছে ফাইল নেই?

যেভাবে কাজ করে

Markdown যোগ করুন

একটি .md ফাইল ছাড়ুন — ছবি থাকলে সেগুলোসহ — অথবা সরাসরি এডিটরে লিখুন বা পেস্ট করুন।

পেজ সাজান

টাইপফেস, পেজ সাইজ ও মার্জিন বেছে নিন, আর সূচিপত্র যোগ করুন। লেখার সঙ্গে সঙ্গে প্রিভিউ আপডেট হয়।

PDF তৈরি করুন

হেডিংগুলো PDF বুকমার্ক হয়ে যায়, আর প্রতিটি লিংক ক্লিকযোগ্য থাকে।

কোন Markdown, আর তা কী হয়ে ওঠে

Markdown একক কোনো স্পেসিফিকেশন নয়, একটি পরিবার। মূল অংশ — হেডিং, এমফাসিস, তালিকা, লিংক, ছবি, ব্লক কোট, কোড ব্লক — সব জায়গায় এক, আর তার বাইরে প্রতিটি ইমপ্লিমেন্টেশন আলাদা। এখানে সমর্থিত হলো ব্যাপকভাবে স্বীকৃত বর্ধিত সেট: টেবিল, সিনট্যাক্স হাইলাইটিংসহ ফেন্সড কোড ব্লক, টাস্ক লিস্ট, স্ট্রাইকথ্রু, ফুটনোট ও ফ্রন্ট ম্যাটার। প্রায় সবাই যা লেখে, তা এতেই পড়ে, আর সীমানাটা পরে আবিষ্কার না করে আগেই জেনে রাখা ভালো।

হেডিং শুধু বড় টেক্সট না হয়ে সত্যিকারের PDF কাঠামো হয়: এদের আউটলাইন লেভেল থাকে, তাই PDF-এ একটি বুকমার্ক সাইডবার আসে, যা দিয়ে নেভিগেট করা যায়। লিংক হয় কার্যকর লিংক অ্যানোটেশন। কোড ব্লক হাইলাইটিংসহ মনোস্পেসড ফন্টে সাজানো হয় — পড়তে আরামদায়ক ডকুমেন্ট আর ধূসর দেয়ালের পার্থক্য এটাই। পেজ সাইজ ও মার্জিন কোথাও থেকে উত্তরাধিকারসূত্রে না নিয়ে পড়ার জন্য বেছে নেওয়া হয়, কারণ কাগজ নিয়ে Markdown ফাইলের কোনো মত নেই।

ছবিগুলো নাগালে থাকতে হবে, আর সবচেয়ে সাধারণ হতাশা এটাই। Markdown ফাইল ছবি ধারণ করে না, শুধু উল্লেখ করে, তাই আপেক্ষিক পাথ কেবল তখনই কাজ করে, যখন ছবিটি ফাইলের পাশাপাশি ছাড়া হয়, আর ওয়েব ঠিকানা কেবল তখনই কাজ করে, যখন সেই সার্ভার অন্য সাইটকে ফাইল আনতে দেয়। যে ছবি খুঁজে পাওয়া যায় না, তা নীরবে ফাঁকা না রেখে PDF-এ চিহ্নিত করা হয়, তাই হারানো ডায়াগ্রাম ডকুমেন্ট পাঠানোর পরে নয়, আগেই চোখে পড়ে।

দুটি জিনিস ইচ্ছে করেই রেন্ডার না করে কোড হিসেবে দেখানো হয়। LaTeX নোটেশনের গণিতের সূত্র আর Mermaid ডায়াগ্রাম — প্রতিটির জন্য আলাদা রেন্ডারার দরকার, আর ভুলভাবে রেন্ডার করা সোর্স দেখানোর চেয়েও খারাপ — ভুল রেন্ডার হওয়া সমীকরণ এমনভাবে ভুল, যা কেউ দেখতে পায় না। Markdown-এর ভেতরের কাঁচা HTML সাধারণ ইনলাইন ফরম্যাটিংয়ের জন্য সামলানো হয়, লেআউটের জন্য নয়, কারণ পেজে ভাগ করা ডকুমেন্টে যেকোনো মার্কআপ ব্লকের জায়গা নেই।

অন্য কিছু দরকার হলে

এ কাজের সিরিয়াস টুল হলো Pandoc, আর এটি বিনামূল্যে। pandoc doc.md -o doc.pdf --pdf-engine=xelatex LaTeX দিয়ে টাইপসেট করে, যা সঠিক হাইফেনেশন, উইডো কন্ট্রোল আর সত্যিকারের সূচিপত্রসহ সত্যিই সুন্দর আউটপুট দেয় — আর টেমপ্লেট দিয়ে ডিজাইনের প্রতিটি দিক নিয়ন্ত্রণ করা যায়। এটি LaTeX গণিতও সঠিকভাবে রেন্ডার করে, যা এখানকার নির্দিষ্ট ঘাটতি। খরচ হলো একটি TeX ডিস্ট্রিবিউশন ইনস্টল করা, যা ছোট নয়।

একবারের ডকুমেন্ট নয়, ডকুমেন্টেশনের জন্য একটি স্ট্যাটিক সাইট জেনারেটর বা mdBook PDF-এর চেয়ে ভালো কিছু তৈরি করে: সার্চযোগ্য, লিংকযোগ্য, আর ফোনে পড়া যায়। ডকুমেন্ট প্রিন্ট, সংযুক্ত বা আর্কাইভ করতে হলে PDF-এ কনভার্ট করুন — আর যেভাবেই হোক, Markdown-কেই মূল সোর্স হিসেবে রাখুন, কারণ সেটিই এডিট ও diff করা যায়।

সাধারণ প্রশ্নোত্তর

Markdown-এর কোন কোন ফিচার সমর্থিত?

GitHub একটি README-তে যা যা দেখায়, সবই: হেডিং, এমফাসিস, স্ট্রাইকথ্রু, লিংক ও অটোলিংক, ছবি, ব্লক কোট, নেস্টেড তালিকা, টাস্ক লিস্ট, অ্যালাইনমেন্টসহ টেবিল, ৩৫টির বেশি ভাষার সিনট্যাক্স হাইলাইটিংসহ ফেন্সড কোড ব্লক, ফুটনোট আর ইনলাইন HTML।

ছবি কীভাবে যোগ করব?

.md ফাইলের সঙ্গে ছবিগুলোও ছাড়ুন (বা পরে যোগ করুন)। এগুলো ফাইলের নাম দিয়ে মেলানো হয়, তাই ![chart](img/chart.png) আপনার ফোল্ডারের যেখানেই থাকুক chart.png খুঁজে পায়। ওয়েবের ছবি আনা হয়, যদি তাদের হোস্ট অনুমতি দেয়।

সূচিপত্র কি পাওয়া যায়?

হ্যাঁ — “সূচিপত্র” টিক দিন, অথবা যেখানে চান সেখানে আলাদা লাইনে [TOC] লিখুন। দুই ক্ষেত্রেই এন্ট্রিগুলো লিংক, যা ঠিক পেজে নিয়ে যায়, আর প্রতিটি হেডিং PDF-এর বুকমার্ক সাইডবারেও দেখা যায়।

আমার টেক্সট কি কোথাও সংরক্ষণ করা হয়?

আপনার Markdown এখানেই একটি ওয়েব পেজে রূপান্তরিত হয়, আর কিছুই সংরক্ষণ করা হয় না। সেই পেজটি তারপর এনক্রিপ্টেড সংযোগে আমাদের সার্ভারে পাঠানো হয়, PDF বানানো হয় এবং সঙ্গে সঙ্গে মুছে ফেলা হয়। কখনো সেই সার্ভারে পৌঁছানো না গেলে টুলটি নিজস্ব কনভার্টারে চলে যায় এবং আপনাকে তা জানিয়ে দেয়।

ফ্রন্ট ম্যাটার কি PDF-এ দেখা যায়?

না। শুরুর YAML ফ্রন্ট ম্যাটার ব্লক পেজ থেকে বাদ পড়ে, আর এর title: হয়ে যায় PDF-এর ডকুমেন্ট শিরোনাম।

Markdown-এর ভেতরে HTML কি চলে?

হ্যাঁ, ফরম্যাটিংয়ের জন্য — <details>, <kbd>, <sup>, টেবিল ইত্যাদি স্বাভাবিকভাবে দেখায়। স্ক্রিপ্ট, ফর্ম আর এমবেড করা ফ্রেম সরিয়ে ফেলা হয়, কারণ একটি ডকুমেন্টের কোড চালানোর কোনো কারণ নেই।

জেনে রাখুন: গণিতের সূত্র ও Mermaid ডায়াগ্রাম রেন্ডার না হয়ে কোড হিসেবে দেখায়। ছবিগুলো ফাইলের সঙ্গে ছাড়তে হবে, বা এমন জায়গায় হোস্ট করা থাকতে হবে, যেখান থেকে আনা যায়; কোনো ছবি না পাওয়া গেলে ফাঁকা না রেখে PDF-এ তা চিহ্নিত করে দেওয়া হয়।