ساخت جدول Markdown (مارک‌داون) آنلاین

ساخت جدول Markdown بدون شمردن خط‌ها و خط‌تیره‌ها

نوشتن دستی جدول در Markdown، با آن همه خط عمودی، خط‌تیره و دونقطه که باید دقیقاً سر جای خود باشند، یکی از دردسرسازترین بخش‌های کار با مارک‌داون است. اگر یک خط عمودی جا بیفتد یا تعداد ستون‌ها در یک سطر اشتباه باشد، جدول در README یا سایت مستندات به‌هم می‌ریزد. با ابزار ساخت جدول Markdown تولتولیا، جدول را در یک ویرایشگر شبیه اکسل پر می‌کنید، چینش هر ستون را از منوی بالای آن انتخاب می‌کنید و کد Markdown مرتب و معتبر را آماده‌ی کپی تحویل می‌گیرید.

ویژگی‌های ابزار

• ویرایشگر جدولی: خانه‌ها را مثل اکسل پر کنید؛ با Enter به ردیف بعد بروید.
• تبدیل اکسل و CSV به Markdown: داده‌های کپی‌شده از Excel، Google Sheets یا فایل CSV به‌طور خودکار تشخیص داده می‌شوند.
• چینش ستون‌ها: چپ، وسط یا راست برای هر ستون.
• افزودن و حذف ردیف و ستون با یک کلیک.
• پیش‌نمایش زنده و خروجی سازگار با GitHub.
• مدیریت خودکار نویسه‌ی خط عمودی داخل خانه‌ها.
• رایگان و بدون ثبت‌نام.

آموزش استفاده

1. روی هر خانه کلیک کنید و تایپ کنید. ردیف اول همیشه سربرگ جدول است.
2. با «افزودن ردیف» و «افزودن ستون» جدول را بزرگ کنید و با «حذف ردیف» و «حذف ستون» آن را کوچک کنید.
3. چینش هر ستون را از منوی بالای آن انتخاب کنید؛ برای ستون‌های فارسی «راست» را انتخاب کنید.
4. اگر داده‌ها را در اکسل یا Google Sheets دارید، خانه‌ها را کپی کنید، در کادر «جای‌گذاری از Excel، Google Sheets یا CSV» قرار دهید و روی «درون‌ریزی» بزنید.
5. پیش‌نمایش زنده را بررسی کنید و خروجی Markdown را کپی کنید.

ساختار جدول Markdown

یک جدول Markdown سازگار با گیت‌هاب از سه بخش تشکیل می‌شود: یک سطر سربرگ، یک سطر جداکننده از خط‌تیره‌ها و یک یا چند سطر داده. ستون‌ها با نویسه‌ی | از هم جدا می‌شوند و همه‌ی سطرها باید به همان تعداد سربرگ ستون داشته باشند:

| نام محصول | قیمت | موجودی |
| :-------- | ---: | :----: |
| لپ‌تاپ     | ۴۵   | دارد   |
| موس       | ۲    | ندارد  |

چینش ستون‌ها در Markdown

چینش هر ستون با دونقطه در سطر جداکننده مشخص می‌شود. این ابزار آن را بر اساس انتخاب شما به‌طور خودکار می‌نویسد:

چینشنحو در سطر جداکنندهچپ:---وسط:---:راست---:

جدول Markdown در متن فارسی و صفحات راست‌به‌چپ

کد Markdown همیشه از چپ به راست نوشته می‌شود؛ یعنی در کد، ستون اول اولین خانه‌ی هر سطر است. اما در صفحاتی که راست‌به‌چپ نمایش داده می‌شوند، مثل بیشتر وبلاگ‌ها و ویکی‌های فارسی، همین ستون اول در سمت راست جدول قرار می‌گیرد. به همین دلیل:

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

کاربردهای ابزار

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

ابزارهای دیگر برنامه‌نویسی تولتولیا مثل JSON Formatter و Validator، تبدیل YAML به JSON و ‎.gitignore ساز را هم امتحان کنید.

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

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

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

چطور داده‌ها را از اکسل وارد کنم؟

خانه‌ها را در اکسل یا Google Sheets انتخاب و کپی کنید، در کادر «جای‌گذاری از Excel، Google Sheets یا CSV» قرار دهید و روی «درون‌ریزی» بزنید. ابزار داده‌های جداشده با Tab یا ویرگول را تشخیص می‌دهد و ساختار سطرها و ستون‌ها را حفظ می‌کند.

اگر داخل یک خانه نویسه‌ی خط عمودی باشد چه می‌شود؟

ابزار هر نویسه‌ی | داخل خانه‌ها را به‌طور خودکار به \| تبدیل می‌کند تا با جداکننده‌ی ستون اشتباه گرفته نشود و ساختار جدول به‌هم نریزد.

آیا می‌توانم داخل یک خانه چند خط متن بنویسم؟

جدول‌های Markdown استاندارد از خانه‌های چندخطی پشتیبانی نمی‌کنند. در گیت‌هاب و بسیاری از رندرکننده‌ها می‌توانید برای شکستن خط داخل خانه از تگ <br> استفاده کنید.

چرا جدول فارسی من در گیت‌هاب برعکس به نظر می‌رسد؟

گیت‌هاب جدول‌ها را چپ‌به‌راست نمایش می‌دهد؛ بنابراین ستون اول در سمت چپ قرار می‌گیرد. اگر مخاطب شما جدول را در گیت‌هاب می‌بیند، ترتیب ستون‌ها را بر همین اساس تنظیم کنید.