Chuyển CSV sang bảng Markdown
Gõ tay một bảng Markdown nghĩa là phải đếm từng dấu gạch đứng và gạch ngang trên mỗi dòng. Thay vào đó, hãy tải file CSV lên để nhận một bảng có sẵn hàng tiêu đề và hàng phân cách, chỉ việc dán vào README, trang wiki hoặc notebook.
Chuyển đổi dữ liệu
hoặc thả tệp CSV, TSV, TXT … vào đây ·
Tối đa 95 MB mỗi tệp· Tối đa 20 tệp· Xóa sau 30 phút
Tệp được xử lý trên máy chủ của chúng tôi và bị xóa sau 30 phút.
Ký tự ngăn cách các cột trong tệp CSV và văn bản, dùng cho cả đọc và ghi. Tự động sẽ nhận diện từ dữ liệu đầu vào và ghi bằng dấu phẩy.
UTF-8 dùng được cho mọi ngôn ngữ. Chọn UTF-8 có BOM nếu Excel trên Windows hiển thị sai ký tự có dấu hoặc ký tự châu Á khi mở tệp CSV.
Với đầu vào Excel, ODS và Numbers: chỉ chuyển trang tính đầu tiên, hoặc mọi trang tính (mỗi trang tính một tệp CSV trong tệp ZIP, hoặc mỗi trang tính một khóa JSON).
Tên thẻ trang tính trong bảng tính mới, tối đa 31 ký tự.
Mảng đối tượng dùng tên cột làm khóa cho từng dòng; mảng của mảng gọn hơn và giữ tiêu đề làm mảng đầu tiên.
Tên phần tử ngoài cùng bao tất cả các dòng; mỗi dòng trở thành một <row> bên trong nó.
Dùng trong các câu lệnh CREATE TABLE và INSERT. Chỉ gồm chữ cái, chữ số và dấu gạch dưới.
Cách đặt dấu trích dẫn và kiểu cột hơi khác nhau giữa các cơ sở dữ liệu; hãy chọn hệ bạn sẽ nhập vào.
Ghi lại các ô ngày tháng theo một định dạng thống nhất. ISO (2026-10-18) an toàn nhất cho cơ sở dữ liệu và mã nguồn; giữ nguyên để chúng như trong tệp gốc.
Cách sử dụng công cụ này
- 1
Tải file CSV lên
Thêm các file .csv, .tsv hoặc .txt có dấu phân tách, tối đa 20 file cùng lúc, mỗi file không quá 95 MB. Chế độ tự động nhận diện dấu phẩy, dấu chấm phẩy, tab và dấu gạch đứng.
- 2
Xác nhận hàng tiêu đề
Tùy chọn Dòng đầu là tiêu đề đang bật, nên dòng 1 sẽ trở thành tiêu đề của bảng. Hãy tắt tùy chọn này trong Cài đặt nâng cao nếu file của bạn bắt đầu bằng dữ liệu.
- 3
Chuyển đổi và dán
Nhấn Chuyển sang bảng Markdown, mở file .md rồi dán bảng vào README, pull request, issue hoặc ghi chú của bạn.
Làm thế nào để chuyển file CSV sang bảng Markdown?
Tải file CSV lên và nhấn Chuyển sang bảng Markdown. Dòng đầu trở thành tiêu đề bảng, một dòng gạch ngang được thêm bên dưới, và mỗi dòng còn lại trở thành một hàng với các ô ngăn cách bằng dấu gạch đứng.
Vì sao lập trình viên chuyển CSV sang Markdown
Tài liệu ngày càng hay nằm trong các file Markdown. Người bảo trì muốn có bảng phiên bản được hỗ trợ trong README, kỹ sư dán số liệu benchmark vào pull request, nhà nghiên cứu lưu danh sách đọc trong Obsidian. Các số liệu thường bắt đầu từ bảng tính hoặc kết quả CSV của một script, và dựng lại bằng tay, với dấu gạch đứng giữa từng ô, vừa chậm vừa dễ sai.
Markdown gốc của John Gruber năm 2004 không có bảng. Cú pháp dấu gạch đứng lan rộng qua PHP Markdown Extra và được đưa vào đặc tả GitHub Flavored Markdown năm 2017, vì vậy nó chạy trên GitHub và hầu hết công cụ theo chuẩn này. Nếu các dòng đến từ Excel, hãy lưu chúng trước bằng Excel sang CSV, rồi chuyển đổi tại đây.
Ví dụ chuyển CSV sang bảng Markdown
runtime,version,status Python,3.13,được hỗ trợ Python,3.9,hết hỗ trợ | tháng 10/2025 Node.js,22,được hỗ trợ
| runtime | version | status | | --- | --- | --- | | Python | 3.13 | được hỗ trợ | | Python | 3.9 | hết hỗ trợ \| tháng 10/2025 | | Node.js | 22 | được hỗ trợ |
Bảng Markdown sau khi chuyển hiển thị ở đâu
| Tổ chức | Yêu cầu | Nguồn |
|---|---|---|
| GitHub | Hiển thị bảng dùng dấu gạch đứng trong README, issue, pull request và wiki, theo đặc tả GFM. | Đặc tả GFM |
| GitLab | GitLab Flavored Markdown hiển thị cùng loại bảng này trong repository, issue và merge request. | — |
| Obsidian | Hiển thị bảng ở chế độ đọc và hỗ trợ chỉnh sửa bảng trong chế độ xem trực tiếp. | — |
| Jupyter | Các ô Markdown trong notebook hiển thị bảng ngay cạnh mã của bạn. | — |
| CommonMark | Đặc tả lõi không có cú pháp bảng; trình hiển thị cần phần mở rộng cho bảng. | commonmark.org |
Thông tin về định dạng CSV và Markdown
CSV
Giá trị phân tách bằng dấu phẩy (CSV)
CSV là định dạng văn bản thuần cho bảng, trong đó mỗi dòng là một hàng và dấu phẩy phân tách các cột. Định dạng đã được dùng từ những ngày đầu của ngành máy tính và được mô tả trong RFC 4180, dù nhiều biến thể dùng dấu chấm phẩy hoặc tab và các bảng mã văn bản khác nhau. Gần như mọi bảng tính, cơ sở dữ liệu và công cụ phân tích đều nhập và xuất được CSV, nên đây là định dạng mặc định để chuyển dữ liệu giữa các hệ thống. CSV chỉ lưu giá trị, không có công thức, định dạng trình bày, nhiều trang tính hay kiểu dữ liệu.
- Nén
- –
- Độ trong suốt
- –
- Ảnh động
- –
- Ra mắt
- –
MD
Văn bản Markdown
Markdown là cú pháp đánh dấu gọn nhẹ do John Gruber tạo ra năm 2004. Cú pháp dùng các ký hiệu văn bản thuần, như # cho tiêu đề, * cho nhấn mạnh và - cho danh sách, vẫn dễ đọc ở dạng văn bản thô và chuyển sang HTML gọn gàng. Markdown là tiêu chuẩn cho tệp README, tài liệu kỹ thuật, wiki, ứng dụng ghi chú và nhiều trình tạo trang tĩnh. Có nhiều phương ngữ, như CommonMark và GitHub Flavored Markdown, khác nhau ở các chi tiết như bảng. Mọi trình soạn thảo văn bản đều mở được tệp .md.
- Nén
- –
- Độ trong suốt
- –
- Ảnh động
- –
- Ra mắt
- 2004 · John Gruber
CSV được chuyển sang Markdown khi một tập dữ liệu nhỏ cần nằm trong tài liệu: bảng tương thích trong README, danh sách phiên bản trong changelog, pull request so sánh các lần chạy benchmark hoặc ghi chú trong kho kiến thức cá nhân.
Việc chuyển đổi gần như không mất giá trị nào, nhưng có thể mất ý nghĩa dữ liệu. CSV giữ mọi dòng cho phần mềm đọc; bảng Markdown là bức tranh dữ liệu dành cho con người, không có kiểu dữ liệu, công thức hay cách gộp ô. Hãy giữ CSV trong repository làm nguồn và tạo lại bảng khi số liệu thay đổi.
Câu hỏi thường gặp về chuyển CSV sang Markdown
Bảng Markdown hiển thị được ở đâu?
Ở bất kỳ nơi nào trình hiển thị hỗ trợ phần mở rộng bảng dùng dấu gạch đứng: GitHub, GitLab, Obsidian, Jupyter notebook và các trình tạo trang tĩnh như MkDocs, Hugo. Trình hiển thị CommonMark thuần túy sẽ hiện các dòng này như văn bản thường, kèm các dấu gạch đứng.
Nếu một giá trị trong CSV chứa ký tự gạch đứng (|) thì sao?
Dấu | không được escape sẽ bắt đầu một ô mới và đẩy mọi cột sang phải. Công cụ ghi nó thành \|, cách escape mà GitHub Flavored Markdown quy định, nên dấu gạch đứng hiện như văn bản trong ô.
Có thể căn số sang phải không?
Có, bằng cách sửa dòng phân cách: ---: căn phải một cột, :---: căn giữa và :--- căn trái. Hãy thêm dấu hai chấm sau khi chuyển đổi; chúng chỉ thay đổi cách bảng hiển thị chứ không đổi dữ liệu.
File CSV lớn cỡ nào thì còn hợp lý để làm bảng Markdown?
Bảng Markdown được tạo ra để đọc, nên vài chục dòng và một vài cột là phù hợp nhất. Bảng hàng nghìn dòng vẫn chuyển đổi được nhưng khiến README khó cuộn; hãy đặt liên kết đến file CSV trong repository và chỉ hiển thị một phần mẫu.
Ký tự xuống dòng trong một ô CSV sẽ được xử lý thế nào?
Một dòng của bảng Markdown phải nằm trên một dòng văn bản, nên giá trị CSV trong ngoặc kép trải nhiều dòng không thể giữ nguyên. Hãy thay các chỗ ngắt dòng trước khi chuyển đổi; trên GitHub bạn có thể dùng <br> trong ô để xuống dòng.
Có thể chuyển bảng sang HTML thay vì Markdown không?
Nếu đích đến là trang web, CMS hoặc email thay vì file Markdown, hãy đặt Chuyển sang là bảng HTML. Với dữ liệu ban đầu ở dạng JSON, trang JSON sang HTML đã chọn sẵn kết quả này.