نحوه استفاده
- سربرگ را در ردیف اول و داده‌ها را زیر آن تایپ کنید، یا «پر کردن از CSV…» را باز کنید و سلول‌ها را از یک صفحهگسترده بچسبانید.
- با دکمه‌ها ردیف و ستون اضافه یا حذف کنید.
- ترازبندی هر ستون را با منوی بالای آن تنظیم کنید.
- Markdown یا HTML را انتخاب کنید و جدول را کپی یا دانلود کنید.
نحوه کار
خروجی Markdown از نحو جدول GitHub Flavored Markdown (GFM) پیروی میکند که GitHub، GitLab، بسیاری از مولدهای مستندات و بیشتر ویرایشگرهای Markdown از آن پشتیبانی می‌کنند. اولین سطر به‌عنوان سربرگ در نظر گرفته می‌شود و پس از آن سطر جداکننده می‌آید که ترازبندی را مشخص میکند: :--- برای چپ، :---: برای وسط، ---: برای راست و --- برای حالت پیش‌فرض.
محتوای سلول‌ها اسکیپ می‌شود تا نتواند جدول را بشکند: یک | داخل سلول به‌صورت \| نوشته می‌شود و شکست خط به <br> تبدیل می‌شود، زیرا هر سطر جدول GFM باید در یک خط بماند. سایر Markdownهای داخل سلول، مانند **bold** یا `code`، حفظ می‌شوند و توسط نمایشگر Markdown رندر خواهند شد. با «تراز کردن ستون‌ها با فاصله»، هر ستون به یک عرض یکسان پوشش داده می‌شود تا جدول به‌صورت متن ساده خوانا باشد؛ نویسه‌هایی مانند چینی، ژاپنی یا کره‌ای دو ستون عرض محسوب می‌شوند. سطرهایی که سلولهای کمتری دارند با سلول خالی پر می‌شوند.
ورودی، متن جداشده با tab (همان چیزی که صفحه‌گسترده‌ها در کلیپ‌بورد قرار می‌دهند)، فایل CSV با کاما یا نقطهویرگول، از جمله فیلدهای داخل گیومه که حاوی کاما، گیومه و شکست خط هستند، و جدول‌های Markdown موجود را می‌پذیرد که سطر ترازبندی آن‌ها نیز خوانده می‌شود.
خروجی HTML یک <table> ساده با <thead> و <tbody> است. متن HTML-اسکیپ می‌شود (& < > ")، شکست‌های خط به <br> تبدیل می‌شوند و ترازبندی با استایل‌های inline text-align تنظیم می‌شود تا بدون stylesheet کار کند.
نمونه‌ها
از صفحه گسترده به README
یک محدوده را در Google Sheets انتخاب کنید، کپی کنید، آن را در کادر ورودی جایگذاری کنید و روی «پر کردن جدول» کلیک کنید. ستون قیمت را راست‌چین کنید و Markdown را در README.md کپی کنید.
متن دارای کاراکتر خط عمودی
سلولی حاوی «Unlimited | fair use» به‌صورت Unlimited \| fair use نوشته می‌شود، بنابراین GitHub نویسه | را نشان می‌دهد به‌جای اینکه یک ستون جدید شروع کند.
مرتب‌سازی جدول موجود
یک جدول Markdown دست‌نویس با فاصله‌گذاری نامرتب بچسبانید، روی «پر کردن جدول» کلیک کنید و نتیجه را با ستون‌های منظم و حفظ ترازبندی کپی کنید.
پرسش‌های متداول
آیا یک سلول می‌تواند شکست خط داشته باشد؟
نه به‌صورت شکست خط واقعی؛ چون در Markdown هر ردیف جدول باید یک خط باشد. تولیدکننده به‌جای آن <br> می‌گذارد که GitHub و بیشتر نمایشگرها آن را به‌صورت شکست خط نشان می‌دهند.
چرا باید یک ردیف سربرگ وجود داشته باشد؟
جدول‌های GFM همیشه با یک ردیف سربرگ و سپس ردیف ترازبندی شروع می‌شوند. اگر عنوان‌های قابل مشاهده نمی‌خواهید، می‌توانید سلولهای سربرگ را خالی بگذارید؛ اما بیشتر نمایشگرها همچنان خط سربرگ را رسم می‌کنند.
آیا می‌توانم سلول‌ها را ادغام کنم؟
خیر. جدول‌های Markdown از سلولهای ادغام‌شده (colspan یا rowspan) پشتیبانی نمی‌کنند. اگر به آن‌ها نیاز دارید، از خروجی HTML استفاده کنید و ویژگی‌های colspan یا rowspan را دستی اضافه کنید.
آیا فاصله‌گذاری ظاهر جدول را هنگام رندر تغییر می‌دهد؟
خیر. فاصله‌های اضافی هنگام رندر Markdown نادیده گرفته می‌شوند. فاصله‌گذاری فقط خواندن و ویرایش منبع را آسان‌تر میکند.
حریم خصوصی
جدول فقط در مرورگر شما ساخته می‌شود. داده‌هایی که تایپ یا جایگذاری می‌کنید بارگذاری، ذخیره یا در تحلیل‌های آماری استفاده نمی‌شوند.