Markdown Table Generator
Chuyển đổi dữ liệu Excel/CSV sang định dạng bảng Markdown.
▶Về công cụ này
Chuyển đổi dữ liệu từ Excel, CSV hoặc Google Sheets sang định dạng bảng Markdown chỉ với một cú nhấp chuột. Hỗ trợ căn lề (Trái, Giữa, Phải).
Giao diện công cụ
Hướng dẫn đầy đủ: Cách viết và định dạng bảng Markdown
Cho dù bạn đang viết tài liệu API trên GitHub, viết bài blog kỹ thuật hay sắp xếp ghi chú trong Obsidian, chắc chắn bạn sẽ cần tạo bảng trong Markdown. Tuy nhiên, việc căn chỉnh các ký tự gạch đứng (|) và gạch ngang (-) theo cách thủ công là cực kỳ tẻ nhạt. Trong hướng dẫn này, chúng tôi sẽ đề cập đến cú pháp cốt lõi, quy tắc căn lề cột và cách chuyển đổi dữ liệu bảng tính sang Markdown ngay lập tức.
Cú pháp bảng Markdown cơ bản
Quy tắc cơ bản để tạo bảng trong Markdown rất đơn giản: sử dụng các ký tự gạch đứng (|) để phân tách các cột và thêm một dòng gạch ngang (-) ngay dưới hàng tiêu đề.
| Tiêu đề 1 | Tiêu đề 2 | Tiêu đề 3 |
| --------- | --------- | --------- |
| Dữ liệu 1 | Dữ liệu 2 | Dữ liệu 3 |
| Dữ liệu 4 | Dữ liệu 5 | Dữ liệu 6 |Mặc dù một số trình phân tích Markdown cho phép bạn bỏ qua các ký tự gạch đứng ở đầu và cuối dòng, nhưng việc giữ lại chúng được coi là một thực hành tốt. Điều này đảm bảo khả năng tương thích tối ưu trên các nền tảng chính như GitHub Flavored Markdown (GFM), Reddit và Jekyll.
Kiểm soát căn lề của các cột
Để cải thiện khả năng đọc dữ liệu, bạn có thể chỉ định căn lề văn bản (trái, giữa hoặc phải) cho từng cột riêng biệt bằng cách đặt dấu hai chấm (:) trên hàng phân cách.
| Kiểu căn lề | Quy tắc cú pháp | Ví dụ mã |
|---|---|---|
| Căn trái (Mặc định) | Dấu hai chấm ở bên trái | | :--- | hoặc | --- | |
| Căn giữa | Dấu hai chấm ở cả hai bên | | :---: | |
| Căn phải | Dấu hai chấm ở bên phải | | ---: | |
Quy tắc chung trong trình bày văn bản: sử dụng căn phải cho các con số và tiền tệ, căn giữa cho các trạng thái, thẻ tag hoặc giá trị boolean, và căn trái cho các đoạn văn bản mô tả.
Hạn chế và các ký tự cần thoát (Escape)
Bảng Markdown có một số hạn chế so với bảng HTML. Hãy lưu ý các điểm sau:
1. Không hỗ trợ nhiều dòng trong một ô
Theo thiết kế, một hàng trong bảng Markdown phải tương ứng với một dòng văn bản trong file `.md`. Nếu bạn cần xuống dòng bên trong một ô, bạn phải chèn thẻ HTML <br> một cách thủ công.
2. Cách viết ký tự gạch đứng bên trong ô
Vì ký tự gạch đứng (|) được dùng để xác định ranh giới cột, việc viết các ký tự này bên trong ô (ví dụ như giá trị tuyệt đối `|x|` hoặc phép toán OR `||`) sẽ làm hỏng việc phân tích bảng. Bạn phải thoát ký tự này bằng dấu gạch chéo ngược (\|) hoặc sử dụng thực thể HTML (|).
Đừng định dạng thủ công: Chuyển đổi từ CSV / Excel
Nếu bảng của bạn có nhiều hơn ba cột, việc nhập thủ công là một sự lãng phí thời gian khủng khiếp.
Quy trình làm việc tối ưu
- Tổng hợp và sắp xếp dữ liệu thô của bạn bằng công cụ bảng tính như Excel hoặc Google Sheets.
- Bôi đen vùng bảng và nhấn Copy (thao tác này sẽ copy dữ liệu dưới dạng "Tab-Separated Values").
- Dán văn bản thô trực tiếp vào Công cụ tạo bảng Markdown (như công cụ phía trên).
- Sao chép kết quả đã được định dạng đẹp mắt vào file README của bạn.
Về công cụ tạo bảng Markdown này
Việc căn chỉnh các cột bằng cách chèn khoảng trắng thủ công là phần khó chịu nhất khi viết bảng Markdown. Công cụ tạo bảng Markdown trên trình duyệt của chúng tôi sẽ lấy dữ liệu copy-paste từ CSV hoặc Excel và tạo ra mã Markdown hợp lệ, được căn chỉnh hoàn hảo ngay lập tức. Mọi quá trình xử lý đều diễn ra an toàn trong trình duyệt của bạn bằng JavaScript phía máy khách, nghĩa là không có dữ liệu nhạy cảm nào của bạn được truyền đến máy chủ bên ngoài.
Cách sử dụng
- Copy dữ liệu từ Excel hoặc CSV và dán vào
- Chọn căn lề (Trái, Giữa, Phải)
- Sao chép mã Markdown và dán vào tài liệu