मुफ़्त Markdown से PDF कनवर्टर

Markdown के बारे में

Markdown एक हल्की मार्कअप भाषा है जो सादे टेक्स्ट को फ़ॉर्मेट किए गए HTML में रूपांतरित करती है। इसका व्यापक रूप से दस्तावेज़ीकरण में उपयोग होता है।

Markdown सिंटैक्स

• #, ##, ### · शीर्षक (h1, h2, h3)
• **टेक्स्ट** · बोल्ड टेक्स्ट
• *टेक्स्ट* · इटैलिक टेक्स्ट
• [लिंक](url) · हाइपरलिंक
• - आइटम · अक्रमबद्ध सूचियाँ
• 1. आइटम · क्रमबद्ध सूचियाँ

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

क्या मैं Markdown में HTML का उपयोग कर सकता हूँ?

हाँ। Markdown इनलाइन HTML का समर्थन करता है, इसलिए आप अपने Markdown में सीधे HTML टैग एम्बेड कर सकते हैं।

कौन से पेज आकार समर्थित हैं?

A4, Letter, A3 और A5 समर्थित हैं। मार्जिन 0 से 50 मिलीमीटर के बीच समायोज्य है।

क्या PDF जनरेशन क्लाइंट-साइड है?

हाँ। सारा रूपांतरण आपके ब्राउज़र में होता है। आपका Markdown कभी हमारे सर्वर पर नहीं भेजा जाता।

यह Converter कैसे काम करता है

Browser-based Markdown-to-PDF tool दो-stage pipeline run करता है। पहले, Markdown source को एक JavaScript Markdown parser द्वारा HTML में parse किया जाता है (यह page marked.js use करता है, MarkedJS organisation द्वारा maintained एक small, fast, MIT-licensed parser)। Result वह HTML है जो आप live preview में देखते हैं। दूसरे, उस HTML को PDF में convert किया जाता है, यह page html2pdf.js use करता है, जो खुद दो libraries wrap करता है: html2canvas computed styles read करके rendered DOM को off-screen canvas पर repaint करता है, और jsPDF उस canvas image को PDF page object में write करता है और file save करता है।

Libraries themselves public CDN से load होती हैं, लेकिन आपका Markdown parsed होता है और PDF पूरी तरह आपके device पर generate होता है। Browser renderer है; page कुछ नहीं छोड़ता।

PDF का Short History

PDF 1991 में Adobe co-founder John Warnock के internal proposal के रूप में शुरू हुआ। वह ऐसा तरीका चाहते थे कि documents हर screen, हर printer, हर operating system पर same दिखें। इसे शुरू करने वाले short paper का title था «The Camelot Project,» और Adobe ने 15 June 1993 को Adobe Acrobat 1.0 के साथ पहला PDF specification publish किया। Adobe ने format को fifteen years तक steward किया पहले PDF 1.7 को ISO पर publish करने से। ISO 32000-1:2008 ने PDF को एक open standard बनाया जो बिना licensing के freely usable है, यह समझने के लिए सबसे important date कि आज हर modern tool, browser, और OS PDF क्यों write कर सकता है। ISO 32000-2:2017 (PDF 2.0) ने improved digital signatures, better Unicode handling, और formal accessibility hooks add किए। 2020 corrected edition April 2023 में PDF Association द्वारा freely downloadable बना दिया गया, जिससे last cost barrier हट गई।

PDF essentially objects का structured container है जो random access के लिए arrange किया गया है, vector graphics (lines और Bézier curves), raster images (typically JPEG या zlib-compressed), embedded fonts (Type 1, TrueType, OpenType), और एक cross-reference table जो readers को पूरी file parse किए बिना कहीं भी jump करने देता है। कई PDF subset standards जानने लायक हैं: PDF/A (archival, ISO 19005, 2005, कुछ भी जो long-term readability तोड़ सकता है वह prohibit है), PDF/X (locked-down colour management के साथ print production), और PDF/UA (Universal Accessibility, ISO 14289-1, 2012, reading order, alt text, Unicode से mapped embedded fonts, और declared document language के साथ fully tagged PDFs require करता है)।

पृष्ठ आकार

A series ISO 216 से आती है (1975 में formalized, Germany के DIN 476 (1922) से traceable)। हर A-size का same √2 (≈ 1.414) aspect ratio है, जिसका मतलब है A3 के long edge को half करने से बिना waste के दो A4 बनते हैं, और A4 को half करने से दो A5 बनते हैं। A0 exactly 1 m² है। North American sizes (Letter, Legal, Tabloid) √2 को ignore करते हैं और colonial paper-making conventions से trace होते हैं:

• A4: 210 × 297 mm (8.3 × 11.7 in)। North America के बाहर global default।
• A3: 297 × 420 mm (11.7 × 16.5 in)। Posters, spreads।
• A5: 148 × 210 mm (5.8 × 8.3 in)। Booklets, zines।
• Letter: 8.5 × 11 in (215.9 × 279.4 mm)। US, Canada, और Philippines में default।

Default 10 mm margin Microsoft Word के default 1 inch (25.4 mm) से tighter है लेकिन code-heavy या table-dense documents के लिए अच्छा काम करता है जहाँ आप हर column fit करना चाहते हैं।

Honest Caveat: Text Selectable नहीं है

क्योंकि converter HTML को canvas पर render करता है और canvas को PDF के अंदर image के रूप में embed करता है, resulting text selectable नहीं है, searchable नहीं है, और screen-reader accessible नहीं है। यह वह faithful picture है जो browser draw करेगा, लेकिन यह एक picture है। Recipe cards, mood boards, या printed handouts जैसे visual artefacts के लिए ठीक है; legal documents, resumes जो recruiter keyword-scan करना चाहता हो, या कुछ भी जिसे accessibility audit pass करना हो (WCAG / Section 508 / EN 301 549) के लिए poor fit है।

यदि आपको selectable text या tagged PDF चाहिए, सही tools हैं Pandoc (LaTeX या wkhtmltopdf या weasyprint के साथ combined) या Adobe Acrobat Pro अपने tagging tools के साथ। Pandoc serious document production के लिए gold standard है, Homebrew या Chocolatey के through installable, command line से run होता है, footnotes, bibliographies, citations, smart quotes, और proper ligatures के साथ full LaTeX-grade typography control देता है।

Page Breaks Force करना

html2pdf.js CSS print-fragmentation properties को honour करता है। क्योंकि Markdown आपको inline HTML embed करने देता है, आप यह paste करके page break force कर सकते हैं:

<div style="break-before: page;"></div>

Legacy alias page-break-before: always भी काम करता है। Other useful properties: table या code block पर break-inside: avoid उसे pages के across split होने से रोकता है; orphans और widows control करते हैं कि page के bottom या top पर कितनी lines साथ रहनी चाहिए।

Clean Output के लिए Tips

• बड़े raster images avoid करें। एक single full-page photo सैकड़ों kilobytes add कर सकती है। Images को embed करने से पहले resize करें, या max-width inline styles में use करें यह limit करने के लिए कि वे कितना बड़ा render करें।
• Tables जो pages के across break नहीं होंगे: उन्हें <div style="break-inside: avoid"> से wrap करें।
• Code blocks को monospace चाहिए। जब कुछ specific set नहीं होता browser आपके OS की monospace font use करता है, Windows पर Consolas, macOS पर Menlo, Linux पर DejaVu Mono। Output हर पर slightly different दिखेगा।
• Realistic content length के साथ test करें। Short test document ठीक है लेकिन 10+ pages पर layout कभी-कभी different दिखती है।
• Letter vs A4। यदि US recipients के साथ share कर रहे हैं, Letter choose करें; बाकी दुनिया A4 expect करती है। Mismatched sizes कुछ break नहीं करते लेकिन printer पर minor margins / scaling oddities cause करते हैं।

इस तरह के Output के लिए Common Markdown

Supported syntax GitHub-flavoured subset है, headings, bold और italic, lists, tables, simple syntax highlighting के साथ code blocks, blockquotes, links और images। Footnotes और Mermaid diagrams इस build में supported नहीं हैं। Basics का quick reminder:

• Headings: # H1 से ###### H6 तक।
• Bold और italic: **bold**, *italic*, ***both***।
• Lists: unordered के लिए - item, ordered के लिए 1. item।
• Links और images: [text](url) और ![alt](url)। Always alt text include करें।
• Tables: hyphen separator row के साथ pipe-delimited rows।
• Fenced code blocks: तीन backticks plus optional language tag।
• Blockquotes: > text।

Markdown की lineage का reminder: John Gruber और Aaron Swartz ने इसे 2004 में «an easy-to-read, easy-to-write plain text format» के रूप में design किया। CommonMark standardisation effort 2014 में शुरू हुई, John MacFarlane (Pandoc), Jeff Atwood (Stack Overflow / Discourse), और GitHub, Reddit और Meteor के engineers द्वारा led। GitHub Flavored Markdown एक CommonMark superset है जो tables, strikethrough, task lists, और autolinks add करता है।

More Questions

मेरे PDF में Text Blurry क्यों है?

क्योंकि converter page को browser की display density पर rasterise करता है। Non-Retina monitor पर resulting image zoomed in होने पर soft दिख सकती है, क्योंकि canvas roughly 96 DPI पर capture होता है print के typical 300 DPI की बजाय। Fix यह है कि higher density पर render करें, html2canvas एक scale option accept करता है (typically Retina-quality output के लिए 2×), larger file sizes की cost पर।

मेरा Code Block Colour-highlight क्यों नहीं होता?

marked.js default में syntax highlighting ship नहीं करता, यह केवल fenced blocks को <pre><code class="language-…"> tags में wrap करता है। Real highlighting के लिए Prism.js या highlight.js जैसी separate library चाहिए, जो इस build में included नहीं है। PDF आपका code monospace में दिखाएगा लेकिन GitHub से expect होने वाले green-and-red colour theme के बिना।

क्या मैं Footnotes या Table of Contents Include कर सकता हूं?

Footnotes ([^1] references और [^1]: definitions) standard GFM spec के बाहर GitHub render feature हैं और इस build में parsed नहीं होते। Table of contents के लिए या तो Markdown extension चाहिए (जैसे markdown-it का TOC plugin) या link list hand-write करना। दोनों के लिए, --toc flag के साथ Pandoc सही tool है।

क्या PDF Accessibility के लिए Tagged होगी?

नहीं। Output एक image-of-pages PDF है बिना semantic tags, alt text, या reading-order hints के, यह PDF/UA conformance check pass नहीं करेगा। Accessibility-required work के लिए (government forms, public-sector docs, WCAG / EN 301 549 / Section 508 के under कोई भी), accessibility filter के साथ Pandoc + LaTeX, Adobe Acrobat Pro के tagging tools, या server-side WeasyPrint pipeline use करें।

क्या कुछ Server को Send होता है?

नहीं। Text आपके browser को कभी नहीं छोड़ता। Marked.js Markdown locally parse करता है, html2canvas off-screen canvas पर paint करता है, jsPDF PDF object build करता है, और browser इसे save करता है। Libraries themselves public CDN से subresource-integrity checks के साथ load होती हैं; वे एक बार fetch होती हैं और फिर cached होती हैं। Page load होने के बाद offline काम करता है।

संबंधित टूल