DevToolPal
VI

Chuyển CSV sang bảng Markdown

Chuyển CSV hoặc TSV thành bảng Markdown căn chỉnh gọn gàng cho README, tài liệu và issue trên GitHub.

Chạy cục bộ, không bao giờ tải lên

Tùy chọn

Đầu vào

0 ký tự · 0 B

Đầu ra

0 ký tự · 0 B

Công cụ này làm gì

Gõ bảng Markdown bằng tay rất mất công: mỗi hàng cần dấu gạch đứng, dòng thứ hai cần dấu gạch ngang, và căn thẳng các cột bằng tay tốn rất nhiều thời gian. Công cụ này chuyển dữ liệu CSV hoặc TSV thành bảng GitHub Flavored Markdown để bạn dán vào README, pull request, issue, trang wiki hay bất kỳ tài liệu Markdown nào.

CSV được phân tích đúng chuẩn, nên các trường trong ngoặc kép có dấu phẩy, dấu ngoặc kép viết đôi và ô nhiều dòng đều được xử lý. Đầu ra được bù khoảng trắng để các cột thẳng hàng ngay cả ở dạng văn bản thuần, giúp bảng dễ đọc và dễ sửa về sau.

Cách dùng

  1. Dán CSV hoặc TSV, tải lên tệp .csv hoặc .tsv, hoặc bấm Ví dụ.
  2. Chọn Căn lề: mặc định, trái, giữa, phải, hoặc Số căn phải để căn phải các cột chỉ chứa số.
  3. Giữ Hàng đầu là tiêu đề bật nếu hàng đầu chứa tên cột; nếu không, tiêu đề sẽ là Column 1, Column 2, v.v.
  4. Tắt Căn thẳng cột nếu bạn muốn các hàng gọn, không bù khoảng trắng.
  5. Sao chép bảng hoặc tải xuống tệp .md.

Các hàng có ít ô hơn tiêu đề sẽ được bù bằng ô trống, nên bảng luôn hợp lệ.

Ví dụ

CSV sau:

Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlier

khi chọn căn lề Số căn phải sẽ thành bảng Markdown này:

| Tool    | Stars | Notes                  |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd      | 34000 | find \| but friendlier |

Dấu phẩy trong trường có ngoặc kép vẫn nằm trong ô, dấu gạch đứng được thoát, còn cột số nhận dấu --: để được căn phải khi hiển thị.

Mẹo

  • Các dấu căn lề ở hàng thứ hai (:--, :-:, --:) quyết định cách căn từng cột trong bảng đã hiển thị.
  • Markdown nội dòng trong ô, như **in đậm**, mã nội dòng hay liên kết, được giữ nguyên và hầu hết trình xem đều hiển thị.
  • Bảng quá rộng khó đọc trên màn hình nhỏ; hãy cân nhắc chia các cột thành nhiều bảng.
  • Để tạo bảng HTML, hoặc chuyển mảng JSON thành bảng Markdown, hãy dùng các công cụ liên quan bên dưới.

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

› Bảng dùng biến thể Markdown nào?

Bảng dùng dấu gạch đứng của GitHub Flavored Markdown (GFM), cũng được GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs và hầu hết trình tạo trang tĩnh hỗ trợ. CommonMark thuần không có cú pháp bảng.

› Dấu gạch đứng và xuống dòng trong ô được xử lý thế nào?

Dấu gạch đứng sẽ kết thúc ô nên được viết thành \|. Không được xuống dòng trong một hàng của bảng, nên chỗ xuống dòng được thay bằng thẻ <br>, GitHub và hầu hết trình hiển thị sẽ hiện nó như một lần xuống dòng.

› Vì sao các cột tiếng Trung, Nhật, Hàn vẫn thẳng hàng?

Khi bật Căn thẳng cột, ô được bù khoảng trắng theo độ rộng hiển thị: ký tự Đông Á rộng được tính là hai cột, nên Markdown gốc vẫn thẳng hàng trong trình soạn thảo dùng phông chữ đơn cách. Bảng sau khi hiển thị trông như nhau trong cả hai trường hợp.

› Tôi có thể chuyển TSV sao chép từ Excel hoặc Google Trang tính không?

Có. Các ô sao chép từ bảng tính được phân cách bằng tab và dấu phân cách được tự động nhận diện. Bạn cũng có thể chọn Tab một cách rõ ràng.