مولد جدول Markdown

چرا تایپ‌کردن دستی جدول‌های مارک‌داون اتلاف وقت است

نحو جدول Markdown — خط‌های عمودی، خط‌تیره‌ها و دونقطه‌های تراز که همگی باید درست در یک راستا قرار بگیرند — یکی از دردسرسازترین بخش‌های نوشتن دستی Markdown است. اگر تعداد ستون‌ها را اشتباه وارد کنید یا یک خط عمودی را جا بیندازید، جدول در README یا سایت ایستا به‌طور نامحسوس خراب نمایش داده می‌شود. این ابزار به‌جای آن، یک شبکه شبیه صفحه‌گسترده در اختیارتان می‌گذارد: سلول‌ها را مثل Excel پر کنید، تراز هر ستون را از منوی کشویی تنظیم کنید و در پایان، به‌صورت خودکار Markdown معتبر و مرتبِ سازگار با GitHub دریافت کنید.

نحوه استفاده

• روی هر سلول در شبکه کلیک کنید و شروع به تایپ کنید — سطر اول همیشه به‌عنوان عنوان جدول در نظر گرفته می‌شود و با نحوهٔ کار جدول‌های GFM مطابقت دارد.
• برای بزرگ‌تر کردن جدول از «افزودن ردیف» یا «افزودن ستون» و برای کوچک‌تر کردن آن از «حذف ردیف» یا «حذف ستون» استفاده کنید.
• برای هر ستون، از فهرست کشویی بالای آن ستون، تراز چپ، وسط یا راست را انتخاب کنید — این گزینه :---: سبک جداکنندهٔ ردیفی که Markdown برای تراز کردن استفاده می‌کند.
• داده‌هایتان از قبل در Excel، Google Sheets یا یک فایل CSV آماده است؟ سلول‌ها را کپی کنید، آن‌ها را در کادر «چسباندن از Excel» بچسبانید و روی «وارد کردن» کلیک کنید — ابزار به‌طور خودکار داده‌های جداشده با تب (صفحه‌گسترده‌ای) یا جداشده با ویرگول (CSV) را تشخیص می‌دهد و شبکه را متناسب با آن بازسازی می‌کند.
• پیش‌نمایش زنده را بررسی کنید تا دقیقاً ببینید جدول چگونه نمایش داده می‌شود، سپس خروجی Markdown را مستقیماً در README، نوشتهٔ وبلاگ یا صفحهٔ مستنداتتان کپی کنید.

چه چیزی یک جدول Markdown را از نظر نحوی معتبر می‌کند؟

یک جدول Markdown سازگار با گیت‌هاب دقیقاً به سه چیز نیاز دارد: یک سطر عنوان، یک سطر جداکننده متشکل از خط‌تیره‌ها (با دونقطه‌های اختیاری برای تراز کردن)، و یک یا چند سطر داده — که همگی از | برای تقسیم ستون‌ها. هر سطر نیز باید دقیقاً به‌اندازهٔ سطر عنوان ستون داشته باشد؛ جزئیاتی که هنگام وارد کردن دستی علامت‌های عمودی به‌سادگی از قلم می‌افتد و این ابزار آن را به‌طور خودکار برایتان مدیریت می‌کند.

موارد کاربرد در دنیای واقعی

• فایل‌های README: یک جدول مقایسه، فهرستی از پارامترهای API یا جدول تغییرات برای یک مخزن گیت‌هاب ایجاد کنید.
• سایت‌های مستندات: بیشتر مولدهای سایت‌های استاتیک (Jekyll، Hugo، Docusaurus، GitBook) جدول‌های GFM را بدون نیاز به تنظیمات اضافی نمایش می‌دهند.
• Notion، Obsidian و دیگر برنامه‌های یادداشت‌برداری مبتنی بر مارک‌داون: مارک‌داون تولیدشده را مستقیماً در هر ویرایشگری که از نحو استاندارد جدول پشتیبانی می‌کند، جای‌گذاری کنید.
• توضیحات درخواست ادغام و قالب‌های issue: بدون ترک مرورگر، به‌سرعت جدولی مرتب برای مقایسه قبل و بعد یا به‌سبک چک‌لیست بسازید.

سؤالات متداول

آیا همهٔ رندرکننده‌های Markdown از جدول‌ها پشتیبانی می‌کنند؟

جدول‌ها بخشی از Markdown سازگار با GitHub (GFM) هستند و پشتیبانی بسیار گسترده‌ای دارند (GitHub، GitLab، بیشتر مولدهای سایت ایستا، Notion و Obsidian)، اما از نظر فنی افزونه محسوب می‌شوند و بخشی از مشخصات اصلی CommonMark نیستند — بنابراین ممکن است تعداد کمی از تجزیه‌گرهای بسیار ساده Markdown آن‌ها را نمایش ندهند.

چطور یک ستون را به راست یا وسط تراز کنم؟

از فهرست کشویی تراز در بالای آن ستون در شبکه استفاده کنید. Markdown این مورد را با استفاده از دونقطه‌ها در سطر جداکننده کدگذاری می‌کند: :--- برای چپ، :---: برای وسط، و ---: برای راست‌چین — این ابزار بر اساس انتخاب شما، آن ردیف را به‌طور خودکار می‌نویسد.

آیا می‌توانم داده‌ها را مستقیماً از Excel یا Google Sheets جای‌گذاری کنم؟

بله — سلول‌ها را مثل همیشه انتخاب و کپی کنید، آن‌ها را در کادر ورود بچسبانید و روی «وارد کردن» کلیک کنید. هر دو برنامه داده‌ها را به‌صورت مقادیر جداشده با تب کپی می‌کنند و این ابزار آن‌ها را به‌طور خودکار تشخیص می‌دهد و در شبکه به جدول تبدیل می‌کند؛ ساختار سطرها و ستون‌ها نیز حفظ می‌شود.

اگر سلولی شامل نویسهٔ عمودی باشد، چه اتفاقی می‌افتد؟

مولد به‌طور خودکار هر نویسهٔ لفظی را اِسکیپ می‌کند | character in a cell as \| تا با جداکننده ستون اشتباه گرفته نشود و ساختار جدول را خراب نکند.