पेशेवर PDF के लिए Markdown फ़ॉर्मेटिंग टिप्स

अच्छी तरह से फ़ॉर्मेट किया गया Markdown अच्छी तरह से फ़ॉर्मेट की गई PDF बनाता है। यह गाइड उन तकनीकों को कवर करता है जो आपके अंतिम आउटपुट में सबसे बड़ा अंतर लाती हैं — शीर्षक संरचना से लेकर तालिका डिज़ाइन तक कोड ब्लॉक स्टाइलिंग तक।

शीर्षक पदानुक्रम मायने रखता है

आपकी शीर्षक संरचना दस्तावेज़ की रूपरेखा निर्धारित करती है। एक तार्किक पदानुक्रम का उपयोग करें:

# दस्तावेज़ शीर्षक (h1)
## मुख्य अनुभाग (h2)
### उप-अनुभाग (h3)
#### विवरण स्तर (h4)

सुझाव:

प्रति दस्तावेज़ एक h1 — यह PDF का शीर्षक बन जाता है।
मुख्य अनुभागों के लिए h2 का उपयोग करें (परिचय, विधियाँ, परिणाम, निष्कर्ष)।
प्रत्येक अनुभाग के भीतर उप-अनुभागों के लिए h3 का उपयोग करें।
स्तरों को छोड़ने से बचें (h2 → h4 बिना h3 के)।

लीगल टेम्पलेट अपने शीर्ष-स्तरीय अनुभागों को स्वचालित रूप से क्रमांकित करता है, इसलिए स्पष्ट शीर्षक पदानुक्रम उस क्रमांकन को सार्थक बनाए रखता है। हर टेम्पलेट में, तार्किक पदानुक्रम एक स्पष्ट दस्तावेज़ रूपरेखा बनाता है।

शानदार दिखने वाली तालिकाएँ

तालिकाएँ सबसे शक्तिशाली सुविधाओं में से एक हैं। PDF में उन्हें अच्छी तरह काम करने का तरीका यहाँ बताया गया है:

| प्रोजेक्ट | स्थिति | बजट | प्रमुख |
| --- | --- | --- | --- |
| वेबसाइट रीडिज़ाइन | प्रगति पर | ₹45,000 | आलिया |
| मोबाइल ऐप | योजना | ₹30,000 | अरविंद |
| API माइग्रेशन | पूर्ण | ₹15,000 | करीना |

कॉलम संरेखण

संरेखण को नियंत्रित करने के लिए विभाजक पंक्ति में कोलन का उपयोग करें:

| आइटम | मात्रा | कीमत |
| :--- | ---: | :---: |
| बाएँ संरेखित | दाएँ संरेखित | केंद्रित |
| विजेट | 5 | ₹240 |
| सेवा | 12 | ₹1,200 |

:--- — बाएँ संरेखित (डिफ़ॉल्ट)
---: — दाएँ संरेखित (संख्या के लिए अच्छा)
:---: — केंद्रित

पाइप वर्ण को एस्केप करना

यदि आपकी सेल सामग्री में | है, तो इसे बैकस्लैश से एस्केप करें:

| कमांड | विवरण |
| --- | --- |
| `cat file \| grep error` | लॉग में त्रुटियाँ खोजें |

सुझाव:

कॉलम लेबल छोटे रखें: लंबे हेडर चौड़े कॉलम बनाते हैं जो ओवरफ़्लो हो सकते हैं।
4-5 कॉलम तक सीमित रखें: अधिक कॉलम A4/Letter पेपर पर पढ़ने में कठिन हो जाते हैं।
निर्यात करने से पहले पूर्वावलोकन करें: चौड़ी तालिकाओं को छोटे लेबल की आवश्यकता हो सकती है।

सिंटैक्स हाइलाइटिंग के साथ कोड ब्लॉक

कोड को तीन बैकटिक और भाषा टैग के साथ लपेटें। PDF स्वचालित रूप से सिंटैक्स हाइलाइटिंग लागू करेगा।

मूल सिंटैक्स

```python
def calculate_growth(revenue: list[float]) -> float:
    if len(revenue) < 2:
        return 0.0
    return (revenue[-1] - revenue[-2]) / revenue[-2] * 100
```

सामान्य भाषाएँ

भाषा	टैग
Python	`python`
JavaScript	`javascript`
TypeScript	`typescript`
Bash / Shell	`bash`
SQL	`sql`
JSON	`json`
YAML	`yaml`
HTML	`html`
CSS	`css`
Rust	`rust`
Go	`go`
Java	`java`
C++	`cpp`

उदाहरण: JSON कॉन्फ़िग

```json
{
  "name": "quarterly-report",
  "templateId": "executive",
  "options": {
    "pageNumbers": true
  }
}
```

उदाहरण: Shell कमांड

```bash
curl -X POST https://api.example.com/v1/reports \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"period": "Q3", "format": "pdf"}'
```

सुझाव:

हमेशा भाषा टैग शामिल करें — इसके बिना कोई हाइलाइटिंग नहीं होती।
छोटे संदर्भों के लिए इनलाइन `कोड` बैकटिक का उपयोग करें जैसे फ़ाइलनाम या true।
साफ पेजिनेशन के लिए ब्लॉक को 50 लाइनों से कम रखें।

आपकी PDF में चित्र

![कंपनी लोगो](https://example.com/logo.png)

आवश्यकताएँ:

चित्र सार्वजनिक रूप से सुलभ URL होने चाहिए (स्थानीय फ़ाइलें नहीं)।
समर्थित प्रारूप: PNG, JPEG, WebP।
चित्र पृष्ठ की चौड़ाई में फ़िट होने के लिए स्वचालित रूप से स्केल होते हैं।

सुझाव:

कस्टम टेम्पलेट में लोगो के लिए, Markdown चित्रों के बजाय चित्र अपलोड सुविधा का उपयोग करें।
तेज़ रेंडरिंग के लिए चित्र 2 MB से कम रखें।
वर्णनात्मक alt टेक्स्ट का उपयोग करें — यह चित्र लोड होने में विफल होने पर दिखाई देता है।

कॉलआउट के लिए ब्लॉककोट

> **मुख्य निष्कर्ष**: राजस्व साल-दर-साल 15% बढ़ा, जो हमारे Q3 अनुमान से 3 प्रतिशत अंक अधिक है।

ब्लॉककोट बाएँ बॉर्डर और इंडेंटेशन के साथ रेंडर होते हैं। इनका उपयोग करें:

मुख्य निष्कर्ष या Takeaways
ग्राहक उद्धरण या प्रशंसापत्र
महत्वपूर्ण नोट्स या चेतावनियाँ
बाहरी स्रोतों से उद्धरण

सूचियाँ — बुलेटेड और क्रमांकित

### मुख्य डिलिवरेबल्स

- Q4 मार्केटिंग योजना
  - सोशल मीडिया कैलेंडर
  - ईमेल अभियान शेड्यूल
- बजट आवंटन
  - विभागीय विवरण
  - आकस्मिक आरक्षित

### कार्य आइटम

1. हितधारकों के साथ ड्राफ्ट की समीक्षा करें
2. शुक्रवार तक फीडबैक शामिल करें
3. अनुमोदन के लिए अंतिम संस्करण जमा करें
4. पिछले संस्करणों को संग्रहित करें

सुझाव:

अक्रमित वस्तुओं के लिए बुलेटेड सूचियों का उपयोग करें।
अनुक्रमिक चरणों के लिए क्रमांकित सूचियों का उपयोग करें।
सूचियों को 3 स्तरों तक नेस्ट करें।
उचित स्पेसिंग के लिए सूचियों से पहले और बाद में एक खाली लाइन छोड़ें।

लिंक और संदर्भ

विवरण के लिए [API दस्तावेज़ीकरण](https://markdowntopdfconverter.com/api-docs) देखें।

प्रश्नों के लिए, [support@markdowntopdfconverter.com](mailto:support@markdowntopdfconverter.com) से संपर्क करें।

लिंक PDF में क्लिक करने योग्य होते हैं। वर्णनात्मक लिंक टेक्स्ट का उपयोग करें — “यहाँ क्लिक करें” से बचें।

Mermaid आरेख

Mermaid सिंटैक्स का उपयोग करके सीधे Markdown में आरेख जोड़ें। वे PDF में तीक्ष्ण वेक्टर ग्राफ़िक्स के रूप में रेंडर होते हैं। Mermaid रेंडरिंग के लिए प्रीमियम योजना आवश्यक है।

प्रत्येक आरेख ```mermaid और अगली पंक्ति पर एक प्रकार की कीवर्ड से शुरू होता है।

फ़्लोचार्ट

प्रक्रियाएँ, निर्णय और कार्यप्रवाह दिखाएँ।

```mermaid
graph TD
    A[Start] --> B{Is approved?}
    B -->|Yes| C[Publish]
    B -->|No| D[Revise]
    D --> B
    C --> E[Done]
```

मुख्य बिंदु: graph TD = ऊपर से नीचे। बाएँ से दाएँ के लिए LR का उपयोग करें। [] = आयत, () = गोल, {} = हीरा, --> = तीर, -->|लेबल| = लेबल वाला तीर।

अनुक्रम आरेख

समय के साथ प्रतिभागियों के बीच अंतःक्रियाएँ दिखाएँ।

```mermaid
sequenceDiagram
    Client->>Server: POST /api/convert
    Server->>Gotenberg: Render PDF
    Gotenberg-->>Server: PDF binary
    Server-->>Client: 200 OK (PDF)
```

मुख्य बिंदु: ->> = ठोस तीर, -->> = धराशायी प्रतिक्रिया। प्रतिभागी स्वचालित रूप से नामों से बनाए जाते हैं।

Gantt चार्ट

समयरेखा पट्टियों के साथ परियोजनाओं की योजना बनाएँ।

```mermaid
gantt
    title Q3 Launch
    dateFormat  YYYY-MM-DD
    section Design
    Wireframes    :2026-07-01, 7d
    Prototype     :2026-07-08, 5d
    section Build
    Frontend      :2026-07-13, 10d
    Backend       :2026-07-13, 12d
    section Launch
    QA            :2026-07-25, 4d
    Go Live       :milestone, 2026-07-30, 0d
```

मुख्य बिंदु: section कार्यों को समूहित करता है। प्रारूप: कार्यनाम :प्रारंभ, अवधि। milestone एक एकल तिथि चिह्नित करता है।

पाई चार्ट

सरल आनुपातिक डेटा।

```mermaid
pie title Revenue by Region
    "North America" : 45
    "Europe" : 30
    "APAC" : 25
```

क्लास आरेख

तकनीकी दस्तावेज़ीकरण के लिए ऑब्जेक्ट संबंध दिखाएँ।

```mermaid
classDiagram
    User <|-- Admin
    User : +String email
    User : +login()
    Admin : +manageUsers()
    Report *-- User
    Report : +String title
    Report : +generatePdf()
```

मुख्य बिंदु: <|-- = इनहेरिटेंस, *-- = कम्पोज़ीशन। + = सार्वजनिक विधि/फ़ील्ड।

अतिरिक्त प्रकार

ये भी समर्थित: स्टेट आरेख, एंटिटी-रिलेशनशिप आरेख, जर्नी मैप, git ग्राफ़, और क्वाड्रेंट चार्ट। पूर्ण सिंटैक्स संदर्भ mermaid.js.org पर।

सुझाव:

Mermaid SVG के रूप में रेंडर होता है — यह किसी भी ज़ूम स्तर पर स्पष्ट रहता है।
Mermaid-समृद्ध दस्तावेज़ों के लिए Creative टेम्पलेट का उपयोग करें (यह आरेख कंटेनरों को पूर्व-आकार देता है)।
आरेख स्वचालित रूप से पृष्ठ चौड़ाई में फ़िट होते हैं। ओवरफ़्लो से बचने के लिए नोड लेबल संक्षिप्त रखें।
निर्यात करने से पहले जटिल आरेखों को लाइव प्रीव्यू में परीक्षण करें।

दस्तावेज़ संरचना जाँच सूची

निर्यात करने से पहले सत्यापित करें:

शीर्ष पर एक h1 शीर्षक
तार्किक शीर्षक पदानुक्रम (h1 → h2 → h3)
तालिकाओं में सुसंगत कॉलम गणना
कोड ब्लॉक में भाषा लेबल हैं
चित्रों में वर्णनात्मक alt टेक्स्ट है
लिंक वर्णनात्मक टेक्स्ट का उपयोग करते हैं
सूचियों के पहले और बाद में खाली लाइनें हैं
कोई HTML टैग नहीं (शुद्ध Markdown का उपयोग करें)

अगले चरण

लाइव प्रीव्यू के साथ कन्वर्टर में इन तकनीकों को आज़माएँ।
अपने ब्रांड की टाइपोग्राफी का उपयोग करने वाला कस्टम टेम्पलेट डिज़ाइन करना सीखें।
अपनी सामग्री के लिए सही टेम्पलेट खोजने के लिए सभी नौ बिल्ट-इन टेम्पलेट्स की तुलना करें।