Tạo bảng Markdown
Chỉnh sửa bảng trong lưới, hoặc dán từ bảng tính, CSV hay TSV, rồi sao chép thành bảng Markdown kiểu GitHub với các cột ngay ngắn.
Chạy ngay trong trình duyệt; những gì bạn nhập không rời khỏi thiết bị của bạn
Bảng tối đa vài nghìn ô. Bảng Markdown chỉ chứa một dòng văn bản trong mỗi ô, nên dấu xuống dòng trong ô được viết là <br> và ký tự gạch đứng được thoát. Dòng đầu tiên luôn là dòng tiêu đề, đúng như GitHub yêu cầu.
Cách tạo bảng Markdown
- Gõ vào lưới, hoặc dán thẳng các ô đã sao chép từ bảng tính. Bạn cũng có thể dán CSV, TSV hoặc một bảng Markdown có sẵn vào hộp văn bản rồi điền lưới từ đó.
- Thêm hoặc xóa hàng và cột, rồi chọn căn trái, căn giữa hoặc căn phải cho từng cột.
- Sao chép Markdown và dán vào README, issue, pull request hoặc tài liệu của bạn.
Bảng Markdown được viết như thế nào
Bảng Markdown kiểu GitHub là văn bản thuần: một dòng tiêu đề, một dòng gạch ngang quyết định cách căn lề, và mỗi hàng dữ liệu một dòng, các ô cách nhau bằng ký tự gạch đứng. Đây là định dạng GitHub hiển thị trong README, issue và pull request, và nhiều công cụ khác, kể cả trang tài liệu và ứng dụng ghi chú, cũng hiểu được nó.
Lưới chứa các ô; hàng đầu tiên là tiêu đề. Mỗi cột có một kiểu căn lề. Căn trái viết là :---, căn giữa :---:, căn phải ---:, còn không căn thì chỉ có các dấu gạch ngang thường. Văn bản trong ô được thoát khi cần: dấu gạch đứng thành \| và dấu xuống dòng thành thẻ HTML <br>. Sau đó công cụ căn các cột bằng khoảng trắng để mã nguồn trông như một bảng, dựa trên độ rộng của từng ký tự chứ không phải số byte, nên các chữ có dấu cũng thẳng hàng.
Dán từ bảng tính là cách bắt đầu nhanh nhất. Bảng tính đưa các ô đã sao chép vào clipboard dưới dạng văn bản phân tách bằng tab, mỗi hàng một dòng, và lưới đọc trực tiếp dạng đó. Tệp CSV và TSV hoạt động tương tự qua hộp dán, kể cả trường đặt trong dấu ngoặc kép và dấu xuống dòng nằm trong ngoặc kép. Nếu bạn dán một bảng Markdown có sẵn, các ô và kiểu căn lề sẽ được đọc lại vào lưới để bạn chỉnh sửa.
Mẹo
- Bạn có JSON thay vì bảng tính? Hãy chuyển nó trước bằng JSON sang CSV, rồi dán kết quả vào đây.
- Xem bảng sẽ hiển thị ra sao với Markdown sang HTML.
- Làm ngược lại, từ trang web về Markdown, hãy dùng HTML sang Markdown.
Câu hỏi thường gặp
Làm sao để biến bảng tính thành bảng Markdown?
Chọn các ô trong Excel, Google Sheets hoặc Numbers, sao chép rồi dán vào bất kỳ ô nào của lưới. Các ô từ bảng tính được dán dưới dạng văn bản phân tách bằng tab, và lưới sẽ được điền từ ô bạn dán vào. Bạn cũng có thể dán CSV hoặc TSV vào hộp phía trên lưới rồi chọn Điền lưới từ văn bản này.
Căn lề cột hoạt động thế nào?
Dòng gạch ngang dưới tiêu đề quyết định cách căn: :--- là căn trái, :---: là căn giữa, ---: là căn phải, còn --- là mặc định. Hãy chọn kiểu căn cho từng cột ở phía trên ô tiêu đề của cột đó.
Điều gì xảy ra với dấu gạch đứng hoặc dấu xuống dòng trong một ô?
Dấu gạch đứng | sẽ kết thúc ô, nên nó được viết là \|. Bảng Markdown không thể chứa dấu xuống dòng thật, vì vậy dấu xuống dòng trong ô được viết là <br>, và GitHub hiển thị nó như một dòng mới.
Tại sao các cột được đệm thêm khoảng trắng?
Phần đệm giúp các cột thẳng hàng để bảng dễ đọc dưới dạng văn bản thuần. Nó không ảnh hưởng đến cách bảng hiển thị. Bỏ chọn Căn thẳng các cột để có dạng ngắn gọn nhất.
Tôi có thể chỉnh sửa một bảng Markdown có sẵn không?
Có. Dán nó vào hộp văn bản và chọn Điền lưới từ văn bản này. Công cụ sẽ đọc các ô và kiểu căn lề rồi đưa vào lưới.
Bảng của tôi có bị tải lên không?
Không. Bảng được tạo ngay trong trình duyệt của bạn và không có gì rời khỏi thiết bị.