Cách dùng CSV & Excel sang bảng Markdown
- Sao chép ô từ Excel hoặc Google Sheets rồi dán vào, mở file CSV / XLSX / JSON, hoặc tải dữ liệu mẫu.
- Chọn kiểu căn lề cho cột — Tự động sẽ căn phải các cột chứa số.
- Bật Căn đều cột để bảng dễ đọc dạng văn bản thuần, hoặc tắt để có kết quả ngắn gọn nhất.
- Sao chép Markdown vào README, issue, pull request hoặc tài liệu của bạn.
Bảng Markdown là gì?
Bảng Markdown là một phần của GitHub-Flavored Markdown (GFM) và được hỗ trợ bởi GitHub, GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs và hầu hết các trình tạo trang tĩnh. Một bảng gồm dòng tiêu đề, dòng phân cách bằng dấu gạch ngang và mỗi dòng dữ liệu một hàng, các ô được ngăn cách bằng dấu gạch đứng:
| plan | users | price |
| :--- | ----: | ----: |
| free | 120 | 0 |
| pro | 48 | 49 |
Cú pháp căn lề
| Ô phân cách | Căn lề |
|---|---|
:--- | Trái |
:---: | Giữa |
---: | Mặc định của trình hiển thị (thường là trái) |
--- | Mặc định của trình hiển thị (thường là trái) |
Chế độ Tự động căn phải các cột chỉ có số, nhờ đó các giá trị thẳng hàng theo chữ số cuối, và căn trái mọi cột còn lại.
Những ký tự làm hỏng bảng
- Dấu gạch đứng (
|) trong ô sẽ bị hiểu là bắt đầu một cột mới, nên được escape thành\|. - Xuống dòng sẽ kết thúc một hàng trong Markdown. Chúng được chuyển thành
<br>(GitHub sẽ hiển thị đúng) hoặc thành khoảng trắng. - Dấu gạch chéo ngược được escape để hiển thị đúng nguyên văn.
Vì sao nên căn đều cột?
Căn đều thêm khoảng trắng để mọi cột có cùng độ rộng trong mã nguồn. Trình hiển thị sẽ bỏ qua khoảng trắng này, nhưng nó giúp file gốc dễ đọc khi review code và khi so sánh bằng công cụ diff. Hãy tắt tùy chọn này để có kết quả gọn nhất, ví dụ khi ô chứa đoạn văn bản dài khiến mỗi dòng quá rộng.
Bắt đầu từ JSON? JSON sang bảng Markdown có các tùy chọn cho dữ liệu lồng nhau. Cần HTML thay thế? Hãy thử trình tạo bảng HTML.
Cũng được tìm dưới tên: excel sang markdown, csv sang markdown, trình tạo bảng markdown, google sheets sang markdown, chuyển bảng markdown online, gfm table.
Các công cụ dùng kèm tốt với CSV & Excel sang bảng Markdown
- Markdown sang HTML — Viết hoặc dán Markdown để nhận HTML sạch ngay lập tức, kèm bản xem trước đã được làm sạch, bảng GitHub-flavored, danh sách việc cần làm và khối code có rào chắn.
- Trình tạo README — Điền vài trường thông tin để nhận một file README.md gọn gàng, sẵn sàng cho GitHub: huy hiệu, cách cài đặt, ví dụ sử dụng, bảng cấu hình, biến môi trường, lộ trình và giấy phép.
- Excel sang JSON — Mở file .xlsx hoặc dán trực tiếp các ô từ Excel hay Google Sheets để nhận JSON sạch.
- JSON sang Excel — Biến mảng JSON thành một workbook Excel thực sự.
Câu hỏi thường gặp
Làm sao để dán bảng Excel vào GitHub?
Bảng Markdown có thể không có tiêu đề không?
Ô có thể chứa xuống dòng không?
<br>, và GitHub cùng hầu hết các trình hiển thị sẽ hiện nó như một dòng mới bên trong ô.