نحوه تبدیل CSV به MD
- متن CSV را جایگذاری کنید یا یک فایل
.csvپشتیبانیشده را آپلود کنید. - جداکننده، کاراکتر نقلقول، ردیف هدر و رمزگذاری کاراکتر را تأیید کنید.
- ردیفهای تجزیهشده و جدول مارکداون تولیدشده را پیشنمایش بگیرید.
- جدول را کپی کنید یا فایل
.mdرا دانلود کنید.
مبدل چه چیزی را حفظ میکند؟
| محتوای منبع | رفتار خروجی توصیهشده | یادداشت تبدیل |
|---|---|---|
| ردیف هدر | از ردیف اول یا ردیف پیکربندیشده به عنوان عنوان استفاده کنید | |
| ردیفها و ستونها | دادههای مستطیلی تجزیهشده را حفظ کنید | |
| جداکنندههای نقلقولدار | کاما یا جداکنندههای داخل فیلدهای نقلقولدار را نگه دارید | |
| نقلقولهای فراری | کاراکترهای نقلقول دوتایی را به درستی رمزگشایی کنید | |
| فیلدهای خالی | سلولهای خالی را رندر کنید | |
| خطوط جدید در فیلدها | فرار، جایگزینی یا استفاده از شکستهای HTML | |
| کاراکترهای پایپ | فرار کنید تا سلولهای GFM معتبر بمانند | |
| تراز | تراز ستون اختیاری تولید کنید |
چه چیزی ممکن است در طول تبدیل تغییر کند؟
محتوای چندخطی و غنی سلول
سلولهای جدول مارکداون پشتیبانی محدودی از شکست خط، لیست و محتوای بلوکی دارند.
مجموعه دادههای بسیار بزرگ
هزاران ردیف میتوانند جدول مارکداون از نظر فنی معتبر اما خواندن آن دشوار باشد. قبل از انتشار خروجی را بررسی کنید.
رمزگذاری کاراکتر
فایلهای رمزگذاریشده با Windows-1252، Shift_JIS یا مجموعه کاراکتر دیگر ممکن است اگر به عنوان UTF-8 رمزگشایی شوند، نادرست نمایش داده شوند.
ردیفهای نامنظم
ردیفهایی با تعداد فیلدهای متفاوت به خطا، قانون تعمیر یا سیاست پر کردن صریح نیاز دارند.
انواع داده
CSV ذاتاً انواع عددی، تاریخ یا بولی را حفظ نمیکند؛ مارکداون متن ارائه میدهد.
کاربردهای رایج CSV به مارکداون
افزودن داده به README
یک ماتریس سازگاری فشرده یا لیست ویژگیها را به جدول تحت کنترل نسخه تبدیل کنید.
اشتراکگذاری نتایج پرسوجو
یک خروجی کوچک را در یک issue، درخواست کشش یا تیکت پشتیبانی جایگذاری کنید.
مستندسازی فیلدهای API
یک طرحواره یا لیست فیلد ذخیرهشده در CSV را به جدول مرجع قابل خواندن تبدیل کنید.
انتقال یادداشتهای جدولی به Obsidian
یک جدول متنی قابل حمل ایجاد کنید و در عین حال CSV را برای محاسبات بیشتر حفظ کنید.
مثال CSV به مارکداون
name,description,status
Alpha,"Fast, simple",active
Beta,"A | B",paused| name | description | status |
|---|---|---|
| Alpha | Fast, simple | active |
| Beta | A \| B | paused |نکاتی برای خروجی مارکداون تمیزتر
- جداکننده را تأیید کنید فایلهای جدا شده با کاما، نقطهویرگول و تب میتوانند در پیشنمایش متن ساده مشابه به نظر برسند.
- از یک تجزیهکننده CSV واقعی استفاده کنید تقسیم ساده رشته، کاماهای نقلقولدار، نقلقولهای فراری و فیلدهای چندخطی را میشکند.
- تعداد ردیف را برای مستندات محدود کنید یک جدول مختصر مفیدتر از جایگذاری کل مجموعه داده است.
- قبل از تبدیل رمزگذاری را بررسی کنید کاراکترهای خراب را در مرحله رمزگشایی تعمیر کنید، نه پس از تولید مارکداون.
- پایپها و شکست خط را پیشنمایش بگیرید این کاراکترها میتوانند ساختار جدول را بشکنند اگر به طور مداوم فرار نکنند.
سوالات متداول
آیا اولین ردیف CSV به هدر جدول تبدیل میشود؟
اولین ردیف پر شده به هدر جدول مارکداون تبدیل میشود. قبل از تبدیل، یک ردیف هدر آماده کنید وقتی CSV مستقیماً با داده شروع میشود.
آیا کاراکترهای پایپ به طور خودکار فرار میشوند؟
بله. کاراکترهای پایپ فرار میشوند تا در سلول صحیح جدول GFM باقی بمانند.
کاماهای داخل فیلدهای نقلقولدار چگونه مدیریت میشوند؟
کاماهای نقلقولدار در همان سلول باقی میمانند. تجزیهکننده CSV همچنین کاراکترهای نقلقول فراری را مدیریت میکند.
با سلولهای CSV چندخطی چه اتفاقی میافتد؟
شکست خط داخل سلول به <br> تبدیل میشود. این کار ردیف را در مارکداون با طعم گیتهاب مستطیلی نگه میدارد.
آیا میتوانم از نقطهویرگول یا تب به عنوان جداکننده استفاده کنم؟
بله. تشخیص جداکننده از کاما، نقطهویرگول، تب و پایپ پشتیبانی میکند.
آیا سلولهای خالی حفظ میشوند؟
بله. سلولهای خالی خالی میمانند و مقادیر ستونهای بعدی را جابهجا نمیکنند.
آیا ستونهای عددی میتوانند راستچین شوند؟
نشانگرهای تراز GFM میتوانند تراز چپ، وسط یا راست را بیان کنند.
فایل CSV چقدر میتواند بزرگ باشد؟
مبدل محدودیت اندازه فایل ثابتی اعمال نمیکند. فایلهای CSV بسیار بزرگ ممکن است پردازش بیشتری طول بکشند و جداول مارکداون آنها ممکن است خواندنشان غیرعملی باشد، بنابراین خروجیهای بزرگ را قبل از انتشار بررسی کنید.
تبدیل مارکداون به PDF
از قبل فایل مارکداون دارید؟ ازمبدل مارکداون به PDFبرای ایجاد یک PDF قابل اشتراکگذاری استفاده کنید.