Trình tạo bảng Markdown

Cấu trúc bảng trong Markdown

Bảng cơ bản:

| Cột A | Cột B | Cột C |
|-------|-------|-------|
| ô 1   | ô 2   | ô 3   |
| ô 4   | ô 5   | ô 6   |

Việc căn chỉnh dùng dấu hai chấm trong hàng phân cách:

| Trái | Giữa | Phải |
|:-----|:----:|-----:|
| a    | b    | c    |

• :--- căn trái
• :---: căn giữa
• ---: căn phải

Những việc trình tạo làm thay cho bạn

• Lấp đầy mỗi ô theo chiều rộng của mục dài nhất trong cột, để các dấu gạch đứng được căn thẳng hàng trong tệp nguồn. Điều này không ảnh hưởng đến kết quả hiển thị – vì Markdown bỏ qua các khoảng trắng thừa – nhưng những người đọc bản so sánh (diff) sẽ rất biết ơn bạn.
• Thoát (escape) dấu gạch đứng bên trong ô thành \|, để một ô chứa a|b không bị chia thành hai cột.
• Giữ nguyên sự căn chỉnh khi bạn thay đổi độ rộng cột.
• Hỗ trợ nhập dữ liệu từ định dạng CSV và TSV; có khả năng nhận diện các trường được đặt trong dấu ngoặc kép cũng như các dấu phẩy nằm bên trong dấu ngoặc.

Những lỗi phổ biến

• Dòng phân cách là bắt buộc. Các bảng Markdown không có dòng |---|---| sẽ được hiển thị dưới dạng văn bản thông thường.
• Không sử dụng các ô nhiều dòng. Mỗi hàng tương ứng với một dòng; hãy chèn giá trị <br> nếu cần phân đoạn nội bộ, vì việc chuyển dòng trong các ô bảng bằng định dạng Markdown không được hỗ trợ.
• Không dùng bảng lồng nhau. Nếu cần, hãy chuyển sang HTML.
• Các ô trống cần một khoảng trắng (hoặc ít nhất là một cặp dấu gạch đứng rỗng). Hãy tránh dùng trực tiếp ||.

Khi nào nên dùng HTML thay thế

Nếu bạn cần colspan, rowspan, ô nhiều dòng hoặc các lớp CSS tùy chỉnh, bảng HTML chính là công cụ phù hợp. Hầu hết các trình phân tích Markdown đều chấp nhận mã bảng HTML thô được đặt trực tiếp trong văn bản.

Những trường hợp bảng Markdown hoạt động hiệu quả

• Các tệp README của GitHub, GitLab và Gitea.
• Mô tả issue và pull request (PR).
• Obsidian, Bear và hầu hết các ứng dụng ghi chú.
• Docusaurus, MkDocs, Hugo, tất cả đều hỗ trợ bảng GFM.