Chuyển CSV sang Markdown online miễn phí

Chuyển tệp CSV sang Markdown online miễn phí. Tải tệp lên và nhận ngay kết quả sạch, sẵn sàng cho LLM. Không cần đăng ký, tối đa 50 MB, không lưu tệp.

CSV sang Markdown: Tạo bảng tính dễ đọc cho mô hình

Về mặt kỹ thuật, mô hình ngôn ngữ có thể đọc được CSV thô. Đó cũng là một cách khủng khiếp để trao dữ liệu. Mỗi hàng là một chuỗi các giá trị được phân tách bằng dấu phẩy không có neo trực quan, tiêu đề xuất hiện một lần ở trên cùng và theo hàng 40 mô hình đang đếm dấu phẩy để tìm ra trường nào là trường nào. Hỏi "lợi nhuận của ngày thứ ba là bao nhiêu sản phẩm" và bạn sẽ nhận được câu trả lời chắc chắn là sai về lề cột nào.

Bảng ống Markdown khắc phục điều đó. Các cột xếp hàng, hàng tiêu đề được đánh dấu rõ ràng là tiêu đề bởi đường phân cách bên dưới nó và mọi ô đều nằm ở vị trí dễ nhìn thấy. Mô hình xử lý định dạng này à — tất cả đều nằm trong dữ liệu đào tạo của họ, trong README và tài liệu cũng như các vấn đề GitHub. Tải lên một .csv ở trên và bạn sẽ nhận được một bảng trở lại trong vài giây. Miễn phí, không cần đăng ký, không có gì giữ lại.

Chiếc bàn ống giúp ích gì cho bạn

Sự khác biệt về cấu trúc là nhỏ trên giấy tờ và lớn trong thực tế:

  • Tiêu đề không rõ ràng. các |---|---| hàng phân cách cho biết bất kỳ Markdown nào trình phân tích cú pháp — và bất kỳ mô hình nào đọc được một triệu trong số đó — dòng trên là tên cột, không phải dữ liệu.
  • Lý luận theo cột trở nên dễ dàng hơn. Những câu hỏi như "khu vực nào đang có xu hướng giảm" hoặc "tìm giá trị ngoại lệ trong cột giá" yêu cầu đọc theo chiều dọc. Một bàn ống giúp đọc theo chiều dọc có sẵn về mặt cấu trúc theo cách mà dấu phẩy không có.
  • Các ô trống vẫn hiển thị. Trong CSV thô, a,,c rất dễ bị đọc sai. Như | a | | c | khoảng cách là hiển nhiên, điều quan trọng khi thiếu dữ liệu là thứ bạn đang hỏi về.
  • Nó tồn tại được dán. Đưa bảng vào cuộc trò chuyện, nhận xét GitHub, trang Notion hoặc một trang tài liệu và nó hiển thị dưới dạng một bảng thực sự chứ không phải là một văn bản mờ nhạt - và nó nằm gọn gàng trong một nhắc nhở cùng với văn xuôi và mã mà không làm mô hình nhầm lẫn cả ba.

Dấu phân cách, trích dẫn và tại sao "CSV" là lời nói dối

Không có một tiêu chuẩn CSV duy nhất nào cả, chỉ có một sự đồng thuận sơ bộ khiến mọi người liên tục đi chệch hướng. Việc phân tích cú pháp phải đối mặt với một số thực tế:

Dấu phân cách không phải lúc nào cũng là dấu phẩy. Xuất từ các hệ thống được cấu hình cho tiếng Đức, tiếng Pháp, Các ngôn ngữ tiếng Tây Ban Nha hoặc tiếng Hà Lan thường sử dụng dấu chấm phẩy vì dấu phẩy ở đó là dấu phân cách thập phân. Được phân tách bằng tab các tập tin được lưu với một .csv gia hạn mọi lúc. Các tập tin được phân cách bằng đường ống hiển thị ngoài xuất cơ sở dữ liệu cũ hơn. Tính năng phát hiện dấu phân cách hoạt động bằng cách lấy mẫu các dòng đầu tiên và chọn ứng viên tạo ra số lượng trường nhất quán - đáng tin cậy trong trường hợp thông thường và có thể bị một tệp đánh lừa có vài hàng đầu tiên chứa rất nhiều dấu chấm phẩy trong văn bản tự do.

Các trường được trích dẫn chứa dấu phân cách. Trường hợp cổ điển là một địa chỉ: "Smith, John",42,"London, UK" là ba trường, không phải năm. Bất cứ điều gì được bao bọc trong dấu ngoặc kép là một giá trị bất kể bên trong nó có gì, bao gồm cả các dòng mới được nhúng - một cột nhận xét có nhiều dòng văn bản là CSV hợp pháp và sẽ trải rộng trên nhiều dòng trong tệp trong khi vẫn là một ô duy nhất. Một trích dẫn bên trong một trường trích dẫn được thoát bằng cách nhân đôi nó: "She said ""no""". Tất cả điều này được xử lý, đó là tại sao tập lệnh phân tách bằng dấu phẩy ngây thơ không thành công khi xuất thực và trình phân tích cú pháp thích hợp thì không.

Một hậu quả đáng biết: nếu dữ liệu của bạn chứa các ký tự ống thực tế, chúng phải được thoát trong đầu ra Markdown nếu không họ sẽ phá vỡ bảng. Điều đó đã được xử lý, nhưng nó có nghĩa là một ô chứa a|b trông hơi khác ở đầu ra so với trong nguồn.

Tiêu đề, hàng rách rưới và tệp không phải là bảng

Tệp CSV không có cách nào để khai báo liệu dòng đầu tiên của nó có phải là tiêu đề hay không. Nó được suy ra - nếu hàng đầu tiên là tất cả văn bản và các hàng bên dưới đều chứa số hoặc ngày, gần như chắc chắn đó là tên cột. Nếu mỗi hàng trông giống nhau, dù sao thì hàng đầu tiên vẫn được coi là tiêu đề vì đó là điều cực kỳ phổ biến trường hợp. Nếu tệp của bạn thực sự không có tiêu đề, bạn sẽ thấy hàng dữ liệu đầu tiên của mình được đưa vào tiêu đề vị trí. Dễ nhận biết, dễ sửa bằng cách thêm dòng tiêu đề trước khi chuyển đổi.

Hàng rách rưới — các hàng có nhiều hoặc ít trường hơn tiêu đề — là những trường hợp phổ biến khác nếp nhăn. Chúng đến từ các tập tin được chỉnh sửa bằng tay, từ một trích dẫn không được thoát trước đó trong quá trình ném tập tin mọi thứ không thẳng hàng hoặc từ các bản xuất có thêm dòng tóm tắt ở cuối. Markdown bảng yêu cầu số lượng cột cố định, do đó các hàng ngắn sẽ được đệm và hình dạng vẫn hợp lệ. Nếu toàn bộ phần của bảng của bạn trông có vẻ bị dịch chuyển bởi một cột, hãy tìm ký tự trích dẫn không cân bằng phía trên nó - gần như luôn là thủ phạm.

Các công cụ BI thường thêm tiêu đề báo cáo và ngày tháng trước tiêu đề thực. Những dòng đó được đọc như một phần của cái bàn. Xóa chúng đầu tiên.

CSV có hương vị Excel và thói quen của nó

Một phần lớn tệp CSV trên thế giới xuất phát từ Excel và Excel để lại dấu vết:

  • Một BOM khi bắt đầu. Excel ghi dấu thứ tự byte trên dữ liệu xuất UTF-8, hiển thị dưới dạng rác vô hình trên tên cột đầu tiên trong các công cụ không loại bỏ nó. Nó bị tước ở đây.
  • Những con số đã trở thành khoa học. ID dài được lưu dưới dạng 1.23457E+14 bởi vì Excel quyết định chúng là những con số. Thiệt hại đó xảy ra trong bảng tính, trước khi CSV tồn tại - không bộ chuyển đổi có thể hoàn tác nó. Định dạng cột dưới dạng văn bản trong nguồn trước khi xuất.
  • Số 0 đứng đầu đã biến mất. Mã bưu điện và mã sản phẩm cũng bị mất theo cùng một cách.
  • Ngày được định dạng lại đến ngôn ngữ của máy, đó là cách 03/04 trở thành mơ hồ mãi mãi.
  • Xuất khẩu Latin-1. "Save as CSV" trên một số phiên bản Windows ghi Windows-1252, không phải UTF-8. Nếu các ký tự có dấu hoặc dấu ngoặc nhọn xuất hiện dưới dạng é hoặc “, đó là mojibake khỏi mã hóa bị gắn nhãn sai — xuất lại dưới dạng CSV UTF-8 và nó sẽ biến mất.

Nếu bạn vẫn có sổ làm việc thay vì xuất, hãy chuyển đổi nó trực tiếp bằng Excel tới Markdown bỏ qua hầu hết cái này - các loại ô được giữ nguyên trong XLSX và bạn nhận được mọi trang tính thay vì chỉ trang đang hoạt động khi ai đó nhấn lưu.

Khi Markdown là lựa chọn sai lầm

Bàn ống có kích thước trần và thấp hơn mọi người mong đợi. Mỗi hàng trả tiền cho các đường ống của nó và đệm, do đó, một bảng có giá trị mã thông báo cao hơn đáng kể so với cùng một dữ liệu dưới dạng giá trị trần. Trên tệp 200 hàng điều đó không liên quan. Khi xuất 50.000 hàng, đó là sự khác biệt giữa phù hợp với ngữ cảnh và không phù hợp.

Chiều rộng là giới hạn khác. Một cái bàn với bốn mươi cột chứa đựng một món súp khó đọc đối với hầu hết người xem, và lợi ích căn chỉnh giúp căn chỉnh định dạng ngay từ đầu sẽ biến mất. Đâu đó khoảng chục cột sự đánh đổi bắt đầu đi theo hướng khác.

Đối với những trường hợp sử dụng CSV sang văn bản thuần túy, cung cấp cho bạn các giá trị mà không cần khung bảng - tốt hơn cho các tệp lớn, phần nhúng và bất kỳ thứ gì được chuyển thành một kịch bản. Chuyển đổi định dạng ở đầu trang này chuyển đổi giữa hai định dạng và giữ nguyên tệp đã chọn của bạn và bộ đếm mã thông báo bên dưới đầu ra sẽ cho bạn biết ngay lập tức liệu phiên bản bảng có phù hợp với ngân sách của bạn.

Nơi này kiếm được nó giữ

  • Phân tích đặc biệt trong cửa sổ trò chuyện. Xuất kết quả truy vấn, chuyển đổi, dán và hỏi câu hỏi. Đối với vài trăm hàng, điều này đánh bại việc viết mã phân tích.
  • Tài liệu. A Trình tạo bảng CSV sang Markdown là con đường nhanh nhất từ bảng tính cấu hình đến bảng trong trang README hoặc trang tài liệu.
  • Xem xét dữ liệu. Các cột được căn chỉnh giúp con người có thể nhìn thấy những điểm bất thường chứ không chỉ là mô hình — việc phát hiện một hàng có trường được hoán đổi sẽ dễ dàng hơn nhiều trong bảng. Lý do tương tự để đọc dữ liệu mẫu dưới dạng bảng tốt hơn khối mã CSV thô trong vấn đề GitHub.
  • Kết hợp dữ liệu với mã. Chuyển đổi CSV, sau đó chuyển đổi dự án của bạn bằng GitHub sang trình chuyển đổi văn bản, và yêu cầu một người mẫu kiểm tra xem logic phân tích cú pháp của bạn có thực sự xử lý được nội dung trong tệp hay không.

Câu hỏi thường gặp

Làm cách nào để chuyển đổi tệp CSV thành bảng Markdown?

Tải lên .csv ở trên và nó trở lại dưới dạng bảng ống, sẵn sàng dán vào README, một vấn đề, trang tài liệu hoặc lời nhắc. Miễn phí, 50 MB mỗi tệp, không cần đăng ký. Hàng đầu tiên được coi là tiêu đề, đây là thứ mà hầu hết mọi lần xuất CSV đều tạo ra.

Nếu CSV của tôi không có hàng tiêu đề thì sao?

Hàng dữ liệu đầu tiên được đưa vào tiêu đề và bạn sẽ mất nó khỏi nội dung. Cách khắc phục dễ nhất là thêm dòng tiêu đề vào tệp nguồn trước khi tải lên - ngay cả những tên giữ chỗ như col1,col2,col3 hoạt động, bởi vì các bảng ống Markdown yêu cầu một hàng tiêu đề theo cú pháp và phải có thứ gì đó lấp đầy nó.

CSV có giá trị lớn đến mức nào khi chuyển đổi thành Markdown?

Thực tế là vài trăm hàng. Các bảng Markdown không có phân trang, không sắp xếp và không cuộn - một bảng mười nghìn hàng là một bức tường ống không giúp được ai và đốt cháy một lượng lớn ngữ cảnh nếu bạn dán nó vào một mô hình. Trước tiên hãy lọc các hàng bạn cần trong bảng tính, sau đó chuyển đổi tập hợp con.

Nó có thoát khỏi các ký tự ống trong dữ liệu của tôi không?

Nó cần phải như vậy, bởi vì một lối thoát | bên trong một ô sẽ được đọc dưới dạng ranh giới cột và âm thầm dịch chuyển mọi giá trị sau nó. Nếu bạn đang làm việc với dữ liệu chứa các đường dẫn - dòng nhật ký, một số URL, ví dụ lệnh - hãy kiểm tra tại chỗ một hàng có chứa một đường dẫn ở đầu ra thay vì giả định.

Bảng có hiển thị trên GitHub không?

Vâng. GitHub Các bảng ống dẫn Markdown có hương vị là những gì điều này tạo ra, do đó, đầu ra hiển thị trong README, các vấn đề, mô tả yêu cầu kéo và nhận xét thảo luận mà không sửa đổi. Cú pháp tương tự hoạt động trong GitLab, nhập Obsidian, Notion và hầu hết các trình tạo trang tĩnh.

Bộ chuyển đổi liên quan

File2Txt lấy bất kỳ tập tin được hỗ trợ nếu bạn muốn sử dụng một trang cho mọi thứ. Đối với các định dạng có cấu trúc khác, JSON tới Markdown và XML tới Markdown xử lý lồng nhau dữ liệu không vừa với lưới phẳng và HTML tới Markdown kéo bàn ra của các trang web đã lưu. Tài liệu đi qua PDF sang Markdown.

Về phía mã có Công cụ chuyển đổi GitLab và một trình chuyển đổi thư mục cục bộ, cộng Web2Txt để cạo các trang trực tiếp. các hướng dẫn chuyển file sang văn bản bao gồm quy trình làm việc rộng hơn.

Repo2Txt được xây dựng và duy trì bởi v12hero, một nhà phát triển độc lập xây dựng các ứng dụng web và ứng dụng gốc ưu tiên quyền riêng tư.