markdown tables gfm reference

Markdown टेबलः GFM टेबल सिंटैक्स के लिए एक पूर्ण गाइड

Markdown तालिकाओं के बारे में सब कुछ GFM वाक्यविन्यास, स्तंभ संरेखण, जटिल तालिकाएं, रेंडर करने की विचित्रताएं, और उन्हें Word दस्तावेजों से कैसे बनाया जाए।

W
__पी_ए__ टीम
·

Markdown तालिकाएँ आपको एक पठनीय प्रारूप में संरचित डेटा प्रदर्शित करने देती हैं जो एक HTML तालिका के रूप में प्रस्तुत होती है. यह मार्गदर्शिका पूर्ण GFM (GitHub स्वादित Markdown) तालिका वाक्यविन्यास, संरेखण विकल्प, उन्नत पैटर्न, और Word तालिकाओं को Markdown में कैसे परिवर्तित करें.

बुनियादी तालिका वाक्यविन्यास

Markdown तालिका में तीन भाग होते हैं:

  1. हेडर पंक्ति स्तंभ नाम
  2. पृथककर्ता पंक्ति पाइप के साथ डैश, तालिका को परिभाषित करता है
  3. डेटा पंक्तियाँ सामग्री
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1, Col 1 | Row 1, Col 2 | Row 1, Col 3 |
| Row 2, Col 1 | Row 2, Col 2 | Row 2, Col 3 |

इस प्रकार प्रस्तुत करता है:

स्तंभ 1स्तंभ 2स्तंभ 3
पंक्ति 1, स्तंभ 1पंक्ति 1, स्तंभ 2पंक्ति 1, स्तंभ 3
पंक्ति 2, स्तंभ 1पंक्ति 2, स्तंभ 2पंक्ति 2, स्तंभ 3

स्तंभ संरेखण

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

| Left aligned | Center aligned | Right aligned |
|:---|:---:|---:|
| text | text | text |
| longer text | longer text | longer text |
बाएं संरेखितकेंद्र संरेखितदाईं ओर संरेखित
texttexttext
लम्बा पाठलम्बा पाठलम्बा पाठ
  • :--- बाएं संरेखित करें (डिफ़ॉल्ट)
  • :---: केंद्र संरेखित करें
  • ---: दाईं ओर संरेखित करें

तालिका कोशिकाओं के अंदर स्वरूपण

अधिकांश इनलाइन Markdown स्वरूपण तालिका कक्षों के भीतर काम करता है:

| Element | Example |
|---|---|
| Bold | **bold text** |
| Italic | *italic text* |
| Code | `inline code` |
| Link | [click here](https://wordtomd.org) |
| Strikethrough | ~~deleted~~ |

क्या काम नहीं करता हैः बहु-पंक्ति सामग्री, घोंसले हुए सूचियाँ, ब्लॉक-स्तरीय तत्व।

कोशिकाओं में पाइप वर्ण

यदि आपको शाब्दिक रूप से एक पाइप की आवश्यकता है | एक सेल के अंदर, एक बैकस्लैश के साथ इसे से बचने के लिएः

| Flag | Description |
|---|---|
| `x \| y` | Bitwise OR operator |

अंतराल के बिना तालिकाएँ

पाइप के चारों ओर अंतर करना वैकल्पिक है। यह मान्य है:

|Column 1|Column 2|
|---|---|
|Cell|Cell|

लेकिन लगातार अंतराल टेबल को अधिक पठनीय बनाता है। अधिकांश संपादक और लिटर अंतरित प्रारूप को पसंद करते हैं।

खाली कक्ष

एक खाली सेल के लिए पाइप के बीच की जगह खाली छोड़ दें:

| A | B | C |
|---|---|---|
| content | | content |
| | content | |

Word तालिकाओं को Markdown में परिवर्तित करना

Word तालिकाएँ स्वचालित रूप से परिवर्तित होती हैं जब आप उपयोग करते हैं WordToMD. The converter handles:

  • मानक ग्रिड → GFM पाइप टेबल
  • स्तंभ चौड़ाई → मानकीकृत (Markdown स्तंभ चौड़ाई को नियंत्रित नहीं करता है)
  • कोशिकाओं के अंदर पाठ स्वरूपण → संरक्षित (बल्ड, इटालिक, लिंक)

क्या परिवर्तित नहीं करता है:

  • विलयित कोशिकाएं (कोलस्पैन/रोसस्पैन) निकटतम कोशिका में ढह गई
  • बहु-पंक्ति कक्ष सामग्री पंक्ति विराम हटाया गया
  • घोंसले हुए मेज आंतरिक मेज सपाट

जटिल Word तालिकाओं को संभालना

विलयित कोशिकाएं

Word की विलय कोशिकाओं में कोई Markdown समकक्ष नहीं है। विकल्प:

  1. पुनर्गठन विलय की गई पंक्तियों को अलग तालिकाओं में विभाजित करें
  2. HTML का प्रयोग करें अधिकांश Markdown प्रोसेसर HTML तालिका वाक्यविन्यास को स्वीकार करते हैं:
<table>
  <tr>
    <th colspan="2">Merged Header</th>
  </tr>
  <tr>
    <td>Cell 1</td>
    <td>Cell 2</td>
  </tr>
</table>

बहु-पंक्ति कक्ष सामग्री

उपयोग <br> कोशिकाओं के अंदर लाइन ब्रेक के लिए (GitHub और अधिकांश प्लेटफार्मों पर काम करता है):

| Step | Description |
|---|---|
| 1 | Open the file<br>Make sure it's .docx format |
| 2 | Drop it on [WordToMD](/#converter) |

बड़े मेज

कई स्तंभों वाले तालिकाओं के लिए, विचार करें कि तालिका सही प्रारूप है या नहीं। विकल्प:

  • परिभाषा सूची (अवधारणा + वर्णन)
  • श्रेणी के अनुसार कई छोटे तालिकाएँ
  • संरचित डेटा के लिए एक कोड ब्लॉक (JSON, YAML)

प्लेटफ़ॉर्म द्वारा तालिका प्रस्तुत करना

मंचGFM तालिकाएँसंरेखणHTML तालिकाएँ
GitHub✅✅✅
GitLab✅✅✅
Notion✅❌❌
Obsidian✅✅✅
GitBook✅✅✅
वीएस कोड पूर्वावलोकन✅✅✅
Confluence (Markdown मैक्रो)✅✅✅
जेकिल/ह्यूगो/एस्ट्रो✅✅✅

सुलभता

अधिक सुलभता के लिए, सुनिश्चित करें कि तालिकाओं में अर्थपूर्ण स्तंभ नामों के साथ एक हेडर पंक्ति हो। स्क्रीन रीडर सेल संदर्भ की घोषणा करने के लिए हेडर पंक्ति का उपयोग करते हैं.

| Product | Price | Availability |
|---|---|---|
| Widget A | $9.99 | In stock |
| Widget B | $14.99 | Out of stock |

लेआउट प्रयोजनों के लिए तालिकाओं का उपयोग करने से बचें केवल वास्तविक तालिकागत डेटा के लिए उनका उपयोग करें।

FAQ

मेरा टेबल रेंडर क्यों नहीं है यह सादे पाठ के रूप में दिखाता है? विभाजक पंक्ति ( |---|---| पंक्ति) अनिवार्य है। इसके बिना, पार्सर तालिका संरचना को पहचान नहीं पाएगा.

क्या मैं हेडर पंक्ति के बिना एक मेज ले सकता हूँ? मानक __पी_ए__ में नहीं। हेडर पंक्ति और विभाजक आवश्यक है। यदि आप एक दृश्य हेडर नहीं चाहते हैं, तो एक खाली हेडर का उपयोग करें: | | | एक विभाजक पंक्ति के साथ।

Word से मेरी तालिकाएँ WordToMD में सही क्यों दिखती हैं लेकिन जब मैं उन्हें कहीं और चिपका देता हूँ तो गलत क्यों दिखती हैं? समस्या आमतौर पर कोशिकाओं में वाइटस्पेस या असंगत पाइप वर्णों को ट्रेल कर रही है. अधिकांश Markdown रेंडरर उदार होते हैं, लेकिन कॉपी-पेस्ट अदृश्य वर्णों को पेश कर सकता है.

मैं डेटा से प्रोग्रामेटिक रूप से एक तालिका कैसे बनाऊं? पुस्तकालय जैसे markdown-table (npm) या पायथनs tabulate सरणियों से Markdown तालिकाएँ उत्पन्न कर सकते हैं. यह CSV या डेटाबेस डेटा के बैच-कन्वर्ट करने के लिए उपयोगी है.

निष्कर्ष

Markdown तालिकाएं संरचित डेटा प्रदर्शित करने के लिए शक्तिशाली हैं और सभी प्रमुख प्लेटफार्मों में व्यापक रूप से समर्थित हैं। Word से शुरू होने वाले तालिकाओं के लिए, WordToMD उन्हें स्वचालित रूप से GFM वाक्यविन्यास में परिवर्तित करता है. जटिल लेआउट के लिए, HTML बैकबैक और उपरोक्त ट्रिक्स आपको आवश्यक नियंत्रण प्रदान करते हैं.