HTML থেকে Markdown রূপান্তরকারী

HTML থেকে Markdown রূপান্তর কী?

HTML থেকে Markdown রূপান্তর HTML মার্কআপকে Markdown-এ রূপান্তরিত করে — একটি হালকা প্লেইন-টেক্সট ফর্ম্যাটিং সিন্ট্যাক্স যা ২০০৪ সালে John Gruber তৈরি করেছিলেন। Markdown রেন্ডার ছাড়াই পাঠযোগ্য হওয়ার জন্য ডিজাইন করা হয়েছিল। HTML-এ যেখানে <strong> এবং <a href=""> এর মতো ওপেনিং ও ক্লোজিং ট্যাগ প্রয়োজন, সেখানে Markdown সংক্ষিপ্ত অক্ষর ব্যবহার করে: **বোল্ড**, [লিংক](url), এবং # হেডিং। HTML থেকে Markdown-এ রূপান্তর করলে এমন ফাইল তৈরি হয় যা কাঁচা HTML-এর চেয়ে পড়তে, সম্পাদনা করতে এবং ভার্সন-কন্ট্রোলে রাখতে সহজ।

রূপান্তর প্রক্রিয়া HTML উপাদানগুলোকে তাদের Markdown সমতুল্যে ম্যাপ করে। একটি <h2> হয়ে যায় ##, একটি <ul><li> হয়ে যায় - আইটেম, এবং একটি <a> ট্যাগ হয়ে যায় [টেক্সট](url)। কিছু HTML উপাদানের সরাসরি Markdown সমতুল্য নেই, যেমন <div>, <span>, বা কাস্টম ডেটা অ্যাট্রিবিউট। কনভার্টারগুলো সাধারণত এই ট্যাগগুলো ছেঁটে ফেলে বা কনফিগারেশন অনুযায়ী কাঁচা HTML হিসেবে পাস করে।

Markdown ডেভেলপার ডকুমেন্টেশনের (GitHub, GitLab, Bitbucket) আদর্শ লেখার ফর্ম্যাট হয়ে উঠেছে, স্ট্যাটিক সাইট জেনারেটর (Hugo, Jekyll, Astro), নোট-নেওয়ার অ্যাপ (Obsidian, Notion) এবং প্রযুক্তিগত ব্লগের জন্যও। বিদ্যমান HTML বিষয়বস্তুকে Markdown-এ রূপান্তর করা ওয়েবসাইট মাইগ্রেশন, CMS বিষয়বস্তু আমদানি বা ওয়েব পৃষ্ঠাগুলো পোর্টেবল ফর্ম্যাটে সংরক্ষণ করার সময় একটি সাধারণ পদক্ষেপ। HTML-এর বিপরীতে, Markdown ফাইলগুলো ভার্সন কন্ট্রোলে পরিষ্কার diff তৈরি করে, যা ডকুমেন্টেশন পরিবর্তনের কোড রিভিউকে কার্যকর করে তোলে।

HTML থেকে Markdown কনভার্টার কেন ব্যবহার করবেন?

HTML-কে ম্যানুয়ালি Markdown হিসেবে পুনরায় লেখা ধীরগতির এবং ত্রুটিপ্রবণ, বিশেষত নেস্টেড তালিকা, টেবিল বা ডজন লিংক সহ পৃষ্ঠাগুলোর জন্য। একটি স্বয়ংক্রিয় কনভার্টার কাঠামোগত ম্যাপিং তাৎক্ষণিকভাবে এবং ধারাবাহিকভাবে পরিচালনা করে।

HTML থেকে Markdown ব্যবহারের ক্ষেত্র

HTML থেকে Markdown উপাদান রেফারেন্স

নিচের টেবিলটি দেখায় কীভাবে সাধারণ HTML উপাদানগুলো তাদের Markdown সমতুল্যে ম্যাপ হয়। এই ম্যাপিং GitHub-Flavored Markdown (GFM) নিয়ম অনুসরণ করে, যা টেবিল, স্ট্রাইকথ্রু এবং টাস্ক তালিকা সহ CommonMark স্পেক প্রসারিত করে। এখানে তালিকাভুক্ত নয় এমন উপাদান (যেমন <div>, <form>, বা কাস্টম ওয়েব কম্পোনেন্ট)-এর কোনো Markdown সমতুল্য নেই এবং সেগুলো হয় ছেঁটে ফেলা হয় অথবা কাঁচা HTML হিসেবে পাস করা হয়।

Markdown ভ্যারিয়েন্ট: GFM বনাম CommonMark বনাম মূল

সব Markdown একরকম নয়। আউটপুট ফর্ম্যাট গুরুত্বপূর্ণ কারণ বিভিন্ন প্ল্যাটফর্ম Markdown ভিন্নভাবে পার্স করে। তিনটি সবচেয়ে সাধারণ ভ্যারিয়েন্ট হলো GitHub-Flavored Markdown (GFM), CommonMark এবং Gruber-এর মূল Markdown।

কোড উদাহরণ

JavaScript (Turndown), Python (markdownify এবং html2text), Go এবং কমান্ড লাইনে Pandoc-এ কার্যকরী উদাহরণ।

import TurndownService from 'turndown'

const turndown = new TurndownService({ headingStyle: 'atx' })
const html = '<h1>Title</h1><p>A <strong>bold</strong> paragraph.</p>'
const md = turndown.turndown(html)
console.log(md)
// → "# Title\n\nA **bold** paragraph."

from markdownify import markdownify

html = '<h2>Section</h2><ul><li>First</li><li>Second</li></ul>'
md = markdownify(html, heading_style='ATX')
print(md)
# → "## Section\n\n- First\n- Second"

import html2text

converter = html2text.HTML2Text()
converter.body_width = 0  # disable line wrapping

html = '<p>Visit <a href="https://example.com">Example</a> for details.</p>'
md = converter.handle(html)
print(md)
# → "Visit [Example](https://example.com) for details."

package main

import (
	"fmt"
	md "github.com/JohannesKaufmann/html-to-markdown"
)

func main() {
	converter := md.NewConverter("", true, nil)
	html := `<h3>Go Example</h3><p>Code: <code>fmt.Println()</code></p>`
	markdown, _ := converter.ConvertString(html)
	fmt.Println(markdown)
	// → "### Go Example\n\nCode: `fmt.Println()`"
}

# Convert an HTML file to Markdown
pandoc input.html -f html -t markdown -o output.md

# Pipe HTML from stdin
echo '<p>Hello <em>world</em></p>' | pandoc -f html -t markdown
# → Hello *world*

# Use GitHub-Flavored Markdown output
pandoc input.html -f html -t gfm -o output.md

সচরাচর জিজ্ঞাসা