HTML to Markdown

HTML से Markdown रूपांतरण क्या है?

HTML से Markdown रूपांतरण, HTML मार्कअप को Markdown में परिवर्तित करता है — Markdown एक हल्की सादे-पाठ स्वरूपण सिंटैक्स है जिसे John Gruber ने 2004 में बनाया था। Markdown को बिना रेंडरिंग के पठनीय होने के लिए डिज़ाइन किया गया था। जहाँ HTML को <strong> और <a href=""> जैसे खुलने और बंद होने वाले टैग की आवश्यकता होती है, वहीं Markdown संक्षिप्त वर्णों का उपयोग करता है: **बोल्ड**, [लिंक](url), और # हेडिंग। HTML को Markdown में बदलने से ऐसी फ़ाइलें प्राप्त होती हैं जो कच्चे HTML की तुलना में पढ़ने, संपादित करने और version control के लिए आसान होती हैं।

रूपांतरण प्रक्रिया HTML तत्वों को उनके Markdown समकक्षों से मैप करती है। <h2> ## बन जाता है, <ul><li> - आइटम बन जाता है, और <a> टैग [पाठ](url) बन जाता है। कुछ HTML तत्वों का कोई सीधा Markdown समकक्ष नहीं होता, जैसे <div>, <span>, या कस्टम डेटा विशेषताएँ। कनवर्टर सामान्यतः इन टैग को हटा देते हैं या कॉन्फ़िगरेशन के आधार पर उन्हें कच्चे HTML के रूप में पास करते हैं।

Markdown डेवलपर दस्तावेज़ीकरण (GitHub, GitLab, Bitbucket), static site generator (Hugo, Jekyll, Astro), नोट-लेखन एप्लिकेशन (Obsidian, Notion), और तकनीकी ब्लॉग के लिए मानक लेखन प्रारूप बन गया है। मौजूदा HTML सामग्री को Markdown में बदलना वेबसाइट स्थानांतरण, CMS सामग्री आयात, या वेब पृष्ठों को पोर्टेबल प्रारूप में संग्रहीत करने का एक सामान्य चरण है। HTML के विपरीत, Markdown फ़ाइलें version control में साफ diff देती हैं, जिससे documentation changes की code review आसान हो जाती है।

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

अक्सर पूछे जाने वाले प्रश्न