Markdown প্রিভিউ দেখুন

ব্যক্তিগত — আপনার ফাইল কখনো সংরক্ষণ করা হয় না

সূচিপত্র যোগ করুন

Markdown

৩৮৩টি অক্ষর · ২০টি লাইন

প্রিভিউ

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

লিখুন বা পেস্ট করুন

অথবা একটি .md ফাইল এখানে ছাড়ুন। টাইপ করার সঙ্গে সঙ্গে প্রিভিউ আপডেট হয়।

যেমন দেখাবে, তেমন দেখুন

টেবিল, টাস্ক লিস্ট, স্ট্রাইকথ্রু, ফুটনোট আর রঙিন ফেন্সড কোড — GitHub-ধাঁচ, সাদামাটা CommonMark নয়।

সঙ্গে নিয়ে যান

HTML কপি করুন, অথবা একটি স্বয়ংসম্পূর্ণ পেজ সেভ করুন, যা যেকোনো জায়গায় খোলে আর ঠিকমতো প্রিন্ট হয়।

কোন Markdown, আর HTML কেন স্যানিটাইজ করা হয়

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

সরাসরি HTML রেন্ডার হয়, তবে আগে স্যানিটাইজ করা হয় — আর এই অংশটিই বোঝা জরুরি। Markdown ইচ্ছে করেই ভেতরে HTML রাখার সুযোগ দেয়, অর্থাৎ যেকোনো জায়গার Markdown ফাইলে script ট্যাগ, ইনলাইন ইভেন্ট হ্যান্ডলার, iframe বা javascript: লিংক থাকতে পারে। সেটি হুবহু রেন্ডার করলে অচেনা কারও কোড আপনার সেশনে চলত, শুধু এই কারণে যে আপনি দেখার জন্য তাঁর README পেস্ট করেছিলেন। কিছু দেখানোর আগেই চালানো যায় এমন সবকিছু বাদ দেওয়া হয়, তাই ফরম্যাটিং টিকে থাকে, কোড থাকে না।

এটি শুধু এই পেজের খুঁটিনাটি নয়, একটি সাধারণ শিক্ষা। ব্যবহারকারীর দেওয়া Markdown রেন্ডার করে এমন যেকোনো সিস্টেম — কমেন্ট বক্স, উইকি, সাপোর্ট টিকিট — স্যানিটাইজ না করলে আসলে ব্যবহারকারীর দেওয়া HTML-ই রেন্ডার করছে, আর “এ তো শুধু Markdown” ভেবেই বিষয়টি নজর এড়িয়ে যায়। Markdown কনভার্ট করা কোনো নিরাপত্তা-সীমা নয়; স্যানিটাইজ করার ধাপটিই তা।

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

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

যে README আপনি নিজে লিখছেন, সেটির প্রিভিউ দেখুন যেখানে সেটি থাকবে সেখানেই। GitHub-এর নিজস্ব এডিটর হুবহু তাদের রেন্ডারিং, এক্সটেনশন ও অ্যাংকরসহ প্রিভিউ দেখায়, আর GitHub CLI — gh markdown-preview — একই রেন্ডারার দিয়ে লোকালি তা করে। ডকুমেন্টেশনের জন্য জেনারেটরটির নিজেরই (MkDocs, Docusaurus, Hugo) লাইভ-রিলোডিং প্রিভিউ আছে, যা আসল স্টাইল ও নেভিগেশন দেখায় — পাঠক যা দেখবেন, ঠিক তা-ই।

যাচাই নয়, এডিট করার জন্য লাইভ প্যানসহ Markdown এডিটর — Obsidian, Typora, বিল্ট-ইন প্রিভিউসহ VS Code — প্রতিবার একটি পেজে পেস্ট করার চেয়ে ভালো, কারণ টাইপ করার সঙ্গে সঙ্গে প্রিভিউ আপডেট হয় আর ফাইলটি যেখানে আছে সেখানেই থাকে। এই পেজ অন্য কারও Markdown পড়ার জন্য, বা আপনাকে পাঠানো কিছুতে এক ঝলক চোখ বুলিয়ে নেওয়ার জন্য।

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

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

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

এটি কোন ধাঁচের Markdown?

GitHub-ধাঁচের, কারণ এখন বাস্তবে “Markdown” বলতে এটাই বোঝায়। টেবিল, টাস্ক লিস্ট, স্ট্রাইকথ্রু, অটোলিংক, ফুটনোট আর রঙিন সিনট্যাক্সসহ ফেন্সড কোড ব্লক — সবই কাজ করে। সাদামাটা CommonMark প্রিভিউতে এর কোনোটিই নেই, সেজন্যই GitHub-এ ঠিকঠাক দেখানো README সেগুলোতে ভাঙা দেখায়।

এতে কি সরাসরি HTML ব্যবহার করা যায়?

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

কোড ব্লক কি হাইলাইট হয়?

হ্যাঁ, ভাষা শনাক্ত করে — README-তে যেসব ভাষা থাকার কথা, সেগুলোর জন্য; GitHub-ধাঁচের রেন্ডারাররা যে হাইলাইটার ব্যবহার করে, সেটিই। শুরুর ফেন্সের পরে ভাষার নাম লিখে দিন, সেই অনুযায়ী রং হবে।

এটিকে কি PDF বানানো যায়?

আমাদের [Markdown থেকে PDF](markdown-to-pdf) টুল ঠিক সেই কাজটিই করে, যথাযথ পেজ ব্রেক ও টাইপোগ্রাফিসহ। এই পেজ পড়া ও যাচাইয়ের জন্য; ওটি ডকুমেন্ট তৈরির জন্য।

আমার Markdown-এর ছবিগুলোর কী হবে?

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

জেনে রাখুন: আপনার Markdown-এর ভেতরের সরাসরি HTML রেন্ডার হয়, তবে আগে পরিষ্কার (স্যানিটাইজ) করে নেওয়া হয় — স্ক্রিপ্ট, ইভেন্ট হ্যান্ডলার আর চলতে পারে এমন সবকিছু বাদ দেওয়া হয়, তাই অন্য কারও README পেস্ট করলে তার কোড চলতে পারে না। GitHub-ধাঁচের Markdown সাপোর্ট করে; আরও বিরল ডায়ালেক্ট ও কাস্টম প্লাগইন সাপোর্ট করে না।

এই টুলটি আপনার ওয়েবসাইটে যোগ করুন

যেকোনো ব্লগ, ক্লাসের পেজ বা হেল্প আর্টিকেলের জন্য ফ্রি। একটি স্নিপেট পেস্ট করলেই আপনার ভিজিটররা আপনার পেজেই এটি ব্যবহার করতে পারবেন।