Cách sử dụng
- Nhập tiêu đề vào hàng đầu tiên và dữ liệu ở các hàng bên dưới, hoặc mở “Điền từ CSV…” và dán các ô từ bảng tính.
- Thêm hoặc xóa hàng và cột bằng các nút.
- Đặt căn chỉnh cho từng cột bằng menu phía trên cột đó.
- Chọn Markdown hoặc HTML rồi sao chép hoặc tải bảng xuống.
Cách hoạt động
Đầu ra Markdown tuân theo cú pháp bảng của GitHub Flavored Markdown (GFM), được GitHub, GitLab, nhiều trình tạo tài liệu và hầu hết trình soạn thảo Markdown hỗ trợ. Hàng đầu tiên trở thành tiêu đề, tiếp theo là hàng phân cách thiết lập căn chỉnh: :--- cho trái, :---: cho giữa, ---: cho phải và --- cho mặc định.
Nội dung ô được escape để không thể phá vỡ bảng: một ký tự | trong ô được viết thành \|, và ngắt dòng trở thành <br>, vì một hàng bảng GFM phải nằm trên một dòng. Các Markdown khác trong ô, chẳng hạn **bold** hoặc `code`, được giữ nguyên và sẽ được trình xem Markdown hiển thị. Khi dùng “Căn cột bằng dấu cách”, mỗi cột được đệm đến cùng độ rộng để bảng dễ đọc dưới dạng văn bản thuần; các ký tự như tiếng Trung, tiếng Nhật hoặc tiếng Hàn được tính là rộng hai cột. Các hàng có ít ô hơn sẽ được điền ô trống.
Trình nhập chấp nhận văn bản phân tách bằng tab (những gì bảng tính đưa vào clipboard), CSV dùng dấu phẩy hoặc chấm phẩy, bao gồm các trường nằm trong dấu ngoặc kép có chứa dấu phẩy, dấu ngoặc kép và ngắt dòng, cũng như các bảng Markdown hiện có với hàng căn chỉnh cũng được đọc.
Đầu ra HTML là một <table> đơn giản với <thead> và <tbody>. Văn bản được HTML-escape (& < > "), ngắt dòng trở thành <br>, và căn chỉnh được đặt bằng kiểu text-align nội tuyến nên hoạt động mà không cần stylesheet.
Ví dụ
Từ bảng tính vào README
Chọn một vùng trong Google Sheets, sao chép, dán vào ô nhập và nhấp “Điền bảng”. Đặt cột giá căn phải và sao chép Markdown vào README.md.
Văn bản có ký tự gạch đứng
Một ô chứa “Unlimited | fair use” được viết thành Unlimited \| fair use, để GitHub hiển thị dấu gạch đứng thay vì bắt đầu một cột mới.
Dọn dẹp bảng hiện có
Dán một bảng Markdown viết tay có khoảng cách không đều, nhấp “Điền bảng”, rồi sao chép kết quả trở lại với tất cả các cột thẳng hàng và căn chỉnh được giữ nguyên.
Câu hỏi thường gặp
Một ô có thể chứa ngắt dòng không?
Không thể là ngắt dòng thực sự, vì mỗi hàng bảng phải nằm trên một dòng trong Markdown. Thay vào đó, trình tạo viết <br>, được GitHub và hầu hết trình xem hiển thị dưới dạng ngắt dòng.
Tại sao phải có hàng tiêu đề?
Bảng GFM luôn bắt đầu bằng hàng tiêu đề, theo sau là hàng căn chỉnh. Nếu bạn không muốn hiển thị tiêu đề, có thể để trống các ô tiêu đề, nhưng hầu hết trình xem vẫn vẽ đường kẻ tiêu đề.
Tôi có thể gộp ô không?
Không. Bảng Markdown không hỗ trợ gộp ô (colspan hoặc rowspan). Nếu cần, hãy dùng đầu ra HTML và tự thêm thuộc tính colspan hoặc rowspan.
Khoảng đệm có làm thay đổi giao diện bảng khi hiển thị không?
Không. Các khoảng trắng thừa bị bỏ qua khi Markdown được hiển thị. Việc thêm khoảng đệm chỉ giúp mã nguồn dễ đọc và chỉnh sửa hơn.
Quyền riêng tư
Bảng chỉ được tạo trong trình duyệt của bạn. Dữ liệu bạn nhập hoặc dán không được tải lên, lưu trữ hoặc đưa vào phân tích.