تبدیل CSV به جدول Markdown
تایپ دستی جدول Markdown یعنی شمردن خط‌های عمودی و خط‌تیره‌ها در تک‌تک سطرها. به‌جای آن فایل CSV را بارگذاری کنید تا جدولی با ردیف سرستون و ردیف جداکننده تحویل بگیرید که آمادهٔ چسباندن در README، صفحهٔ ویکی یا نوت‌بوک است.
مبدل داده
یا فایل‌های CSV, TSV, TXT … را اینجا رها کنید ·
حداکثر 95 MB برای هر فایل· تا 20 فایل· حذف پس از 30 دقیقه
فایل‌ها روی سرورهای ما پردازش می‌شوند و پس از 30 دقیقه حذف می‌شوند.
نویسه‌ای که ستونها را در فایل‌های CSV و متنی جدا میکند، هم برای خواندن و هم برای نوشتن. حالت خودکار آن را از ورودی تشخیص میدهد و با ویرگول مینویسد.
UTF-8 برای همه زبان‌ها کار میکند. اگر Excel در ویندوز هنگام باز کردن CSV نویسه‌های اروپایی یا آسیایی را خراب نشان میدهد، UTF-8 با BOM را انتخاب کنید.
ورودی Excel، ODS و Numbers: فقط برگه اول تبدیل شود یا همه برگه‌ها (برای هر برگه یک CSV داخل ZIP، یا برای هر برگه یک کلید JSON).
نام زبانه برگه در صفحه‌گسترده جدید، حداکثر 31 نویسه.
آرایه‌ای از شیءها برای هر ردیف از نام ستونها به‌عنوان کلید استفاده میکند؛ آرایه‌ای از آرایه‌ها فشرده‌تر است و سرستون را به‌عنوان آرایه اول نگه می‌دارد.
نام عنصر بیرونی که همه ردیف‌ها را در بر می‌گیرد؛ هر ردیف داخل آن به یک <row> تبدیل میشود.
در دستورهای CREATE TABLE و INSERT استفاده میشود. فقط حروف انگلیسی، ارقام و زیرخط.
نقل‌قول‌گذاری و نوع ستونها بین پایگاه‌های داده کمی فرق دارد؛ همان را که می‌خواهید در آن وارد کنید انتخاب کنید.
سلول‌های تاریخ را در یک قالب بازنویسی میکند. ISO (2026-10-18) برای پایگاه داده و کد امن‌ترین است؛ «بدون تغییر» آن‌ها را همان‌طور که در منبع هستند نگه می‌دارد.
نحوه استفاده از این ابزار
- 1
فایل CSV را بارگذاری کنید
فایل‌های .csv، .tsv یا .txt جداشده با نویسه را اضافه کنید؛ تا 20 فایل در هر بار و هر کدام حداکثر 95 MB. تشخیص خودکار، کاما، نقطه‌ویرگول، تب و خط عمودی را پشتیبانی میکند.
- 2
ردیف سرستون را تأیید کنید
گزینهٔ ردیف اول سرستون است روشن است، پس ردیف 1 به عنوان سرستون جدول در نظر گرفته میشود. اگر فایل شما از همان ردیف اول با داده شروع میشود، آن را در تنظیمات پیشرفته خاموش کنید.
- 3
تبدیل کنید و بچسبانید
روی تبدیل به جدول Markdown بزنید، فایل .md را باز کنید و جدول را در README، پول‌ریکوئست، issue یا یادداشت خود جایگذاری کنید.
چطور فایل CSV را به جدول Markdown تبدیل کنم؟
CSV را بارگذاری کنید و روی تبدیل به جدول Markdown بزنید. ردیف اول سرستون جدول میشود، زیر آن ردیفی از خط‌تیره اضافه میشود و هر خط دیگر به ردیفی با سلول‌های جداشده با خط عمودی تبدیل میشود.
چرا برنامه‌نویسان CSV را به Markdown تبدیل می‌کنند
مستندات همیشه در فایل‌های Markdown جمع می‌شوند. نگه‌دارندهٔ پروژه جدول نسخه‌های پشتیبانی‌شده را در README می‌خواهد، مهندسی اعداد بنچمارک را در پول‌ریکوئست می‌گذارد و پژوهشگری فهرست مطالعه‌اش را در Obsidian نگه می‌دارد. اعداد معمولاً از صفحه‌گسترده یا خروجی CSV یک اسکریپت می‌آیند و بازسازی دستی آن‌ها با خط عمودی میان هر سلول کند است و خطا در آن آسان.
Markdown اصلی جان گروبر در سال 2004 اصلاً جدول نداشت. نحو خط عمودی از طریق PHP Markdown Extra رواج یافت و در سال 2017 در مشخصات GitHub Flavored Markdown نوشته شد؛ به همین دلیل در GitHub و بیشتر ابزارهایی که از آن پیروی می‌کنند کار میکند. اگر ردیف‌ها از Excel آمده‌اند، ابتدا با Excel به CSV ذخیره کنید و بعد اینجا تبدیل کنید.
نمونهٔ تبدیل CSV به جدول Markdown
runtime,version,status Python,3.13,پشتیبانی‌شده Python,3.9,پایان پشتیبانی | اکتبر 2025 Node.js,22,پشتیبانی‌شده
| runtime | version | status | | --- | --- | --- | | Python | 3.13 | پشتیبانی‌شده | | Python | 3.9 | پایان پشتیبانی \| اکتبر 2025 | | Node.js | 22 | پشتیبانی‌شده |
جدول Markdown تبدیل‌شده کجا نمایش داده میشود
| سازمان | الزام | منبع |
|---|---|---|
| GitHub | جدولهای با خط عمودی را در README، issue، پول‌ریکوئست و ویکی نمایش میدهد و از مشخصات GFM پیروی میکند. | مشخصات GFM |
| GitLab | GitLab Flavored Markdown همین جدول‌ها را در مخازن، issueها و merge requestها نمایش میدهد. | — |
| Obsidian | جدول‌ها را در حالت خواندن نشان میدهد و در پیش‌نمایش زنده ویرایش جدول را ارائه میکند. | — |
| Jupyter | سلول‌های Markdown در نوت‌بوک‌ها جدول را کنار کد شما نمایش میدهند. | — |
| CommonMark | مشخصات اصلی نحو جدول ندارد؛ رندررها به افزونهٔ جدول نیاز دارند. | commonmark.org |
مشخصات فرمت‌های CSV و Markdown
CSV
مقادیر جداشده با کاما
CSV یک قالب متن ساده برای جدول‌هاست که در آن هر خط یک ردیف است و ستونها با کاما از هم جدا می‌شوند. این قالب از روزهای نخست رایانه استفاده می‌شده و در RFC 4180 توضیح داده شده است، هرچند بسیاری از گونه‌ها از نقطه‌ویرگول یا تب و رمزگذاری‌های متنی متفاوت استفاده می‌کنند. تقریباً هر صفحه‌گسترده، پایگاه داده و ابزار تحلیلی می‌تواند آن را وارد یا صادر کند و به همین دلیل قالب پیش‌فرض انتقال داده بین سیستم‌هاست. CSV فقط مقادیر را ذخیره میکند و فرمول، قالب‌بندی، چند برگه یا نوع داده ندارد.
- فشرده‌سازی
- –
- شفافیت
- –
- انیمیشن
- –
- سال معرفی
- –
MD
Markdown
Markdown یک نحو نشانه‌گذاری سبک است که John Gruber در سال 2004 ساخت. از نمادهای متن ساده مانند # برای عنوان، * برای تأکید و - برای فهرست استفاده میکند که به صورت متن خام هم خوانا می‌مانند و به‌خوبی به HTML تبدیل می‌شوند. این قالب استاندارد فایل‌های README، مستندات، ویکی‌ها، برنامه‌های یادداشت و بسیاری از مولدهای سایت ایستا است. گویش‌های مختلفی مانند CommonMark و GitHub Flavored Markdown وجود دارد که در جزئیاتی مثل جدول‌ها فرق دارند. هر ویرایشگر متنی می‌تواند فایل‌های .md را باز کند.
- فشرده‌سازی
- –
- شفافیت
- –
- انیمیشن
- –
- سال معرفی
- 2004 · John Gruber
وقتی یک مجموعه‌داده کوچک باید داخل مستندات جا بگیرد، CSV به Markdown تبدیل میشود: جدول سازگاری در README، فهرست نسخه‌ها در changelog، پول‌ریکوئستی که نتایج بنچمارک را مقایسه میکند یا یادداشتی در پایگاه دانش شخصی.
تبدیل برای مقادیر تقریباً بی‌اتلاف است، اما برای مقصود داده نه. CSV همهٔ ردیف‌ها را برای خواندن توسط نرم‌افزار نگه می‌دارد؛ جدول Markdown تصویری از داده برای انسان است و نوع داده، فرمول یا ادغام سلول ندارد. CSV را به عنوان منبع در مخزن نگه دارید و هر وقت اعداد تغییر کردند، جدول را دوباره بسازید.
پرسش‌های متداول تبدیل CSV به Markdown
جدولهای Markdown کجا نمایش داده می‌شوند؟
در هر جا که رندرر از افزونهٔ جدول با خط عمودی پشتیبانی کند: GitHub، GitLab، Obsidian، نوت‌بوک‌های Jupyter و سازندگان سایت ایستا مانند MkDocs و Hugo. رندرر کاملاً مطابق CommonMark همان خطوط را به صورت متن ساده و با خط‌های عمودی نمایش میدهد.
اگر یکی از مقادیر CSV کاراکتر | داشته باشد چه میشود؟
علامت | بدون escape یک سلول جدید شروع میکند و همهٔ ستونها را به راست جابهجا میکند. مبدل آن را به شکل \| مینویسد، یعنی escapeای که GitHub Flavored Markdown تعریف کرده است، و خط عمودی به صورت متن داخل سلول نمایش داده میشود.
آیا میتوانم اعداد را راستچین کنم؟
بله، با ویرایش ردیف جداکننده: ---: ستون را راستچین، :---: وسطچین و :--- چپچین میکند. دو نقطه را بعد از تبدیل اضافه کنید؛ فقط شیوهٔ نمایش جدول را تغییر میدهند، نه داده را.
چه حجمی از CSV برای تبدیل به جدول Markdown مناسب است؟
جدولهای Markdown برای خواندن ساخته شدهاند، پس چند ده ردیف و چند ستون محدود بهترین نتیجه را میدهد. جدولی با هزاران ردیف هم تبدیل میشود، اما پیمایش README را سخت میکند؛ بهتر است به فایل CSV در مخزن پیوند بدهید و فقط یک نمونه نشان دهید.
شکست خط داخل یک فیلد CSV چه میشود؟
هر ردیف جدول Markdown باید در یک خط بماند، بنابراین مقدار داخل گیومهٔ CSV که چند خطی است را نمی‌شود همان‌طور نگه داشت. پیش از تبدیل این شکست‌های خط را جایگزین کنید؛ در GitHub می‌توانید داخل سلول از <br> برای ایجاد خط جدید استفاده کنید.
آیا میتوانم جدول را به HTML تبدیل کنم؟
اگر مقصد صفحهٔ وب، CMS یا ایمیل است و نه فایل Markdown، تبدیل به را روی جدول HTML بگذارید. برای دادهای که از JSON شروع میشود، در صفحهٔ JSON به HTML همین خروجی از پیش انتخاب شده است.