Các bảng Markdown cho phép bạn hiển thị dữ liệu có cấu trúc trong định dạng có thể đọc được hiển thị như một bảng HTML. Hướng dẫn này bao gồm toàn bộ GFM (GitHub Flavored Markdown) table syntax, tùy chọn sắp xếp, mô hình nâng cao, và làm thế nào để chuyển đổi Word bảng để Markdown.
Phương pháp tổng hợp bảng cơ bản
Một bảng Markdown có ba phần:
- Dòng tiêu đề tên cột
- Dòng phân tách bảng với ống, xác định bảng
- Dòng dữ liệu nội dung
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1, Col 1 | Row 1, Col 2 | Row 1, Col 3 |
| Row 2, Col 1 | Row 2, Col 2 | Row 2, Col 3 |Định nghĩa như sau:
| Cột 1 | Cột 2 | Cột 3 |
|---|---|---|
| Dòng 1, Cột 1 | Dòng 1, Cột 2 | Dòng 1, Cột 3 |
| Dòng 2, Cột 1 | Dòng 2, Cột 2 | Dòng 2, Cột 3 |
Phân phối cột
Sử dụng dấu chấm trong hàng phân tách để kiểm soát sự sắp xếp:
| Left aligned | Center aligned | Right aligned |
|:---|:---:|---:|
| text | text | text |
| longer text | longer text | longer text || Định hướng trái | Trung tâm được sắp xếp | Định hướng bên phải |
|---|---|---|
| text | text | text |
| văn bản dài hơn | văn bản dài hơn | văn bản dài hơn |
:---Định hướng trái (bản mặc định):---:Định vị trung tâm---:Định hướng phải
Định dạng bên trong các ô bảng
Hầu hết định dạng inline Markdown hoạt động bên trong các ô bảng:
| Element | Example |
|---|---|
| Bold | **bold text** |
| Italic | *italic text* |
| Code | `inline code` |
| Link | [click here](https://wordtomd.org) |
| Strikethrough | ~~deleted~~ |Những gì không hoạt động: nội dung nhiều dòng, danh sách tổ hợp, các yếu tố cấp khối.
Các ký tự ống trong tế bào
Nếu bạn cần một ống thật sự | bên trong một ô, thoát khỏi nó bằng một backslash:
| Flag | Description |
|---|---|
| `x \| y` | Bitwise OR operator |Bảng không có khoảng cách
Khoảng cách xung quanh ống là tùy chọn. Điều này là hợp lệ:
|Column 1|Column 2|
|---|---|
|Cell|Cell|Nhưng khoảng cách nhất quán làm cho các bảng dễ đọc hơn. Hầu hết các biên tập viên và người viết bài thích định dạng khoảng cách.
Các ô trống
Để không gian giữa các ống trống cho một ô trống:
| A | B | C |
|---|---|---|
| content | | content |
| | content | |Chuyển đổi Word bảng thành Markdown
Word bảng chuyển đổi tự động khi bạn sử dụng WordToMD. The converter handles:
- Mạng tiêu chuẩn → GFM bàn ống
- Độ rộng cột → tiêu chuẩn hóa (Markdown không kiểm soát độ rộng cột)
- Định dạng văn bản bên trong ô → được bảo quản (đứng đậm, lật, liên kết)
Điều gì không chuyển đổi:
- Các tế bào sáp nhập (colspan/rowspan) sụp đổ vào tế bào gần nhất
- Nội dung tế bào nhiều dòng đoạn đường được loại bỏ
- Bàn nội thất bằng phẳng
Quá trình xử lý phức tạp Word
Các tế bào sáp nhập
Words hợp nhất tế bào không có Markdown tương đương. Lựa chọn:
- Cải tổ lại Phân chia các hàng được sáp nhập thành các bảng riêng biệt
- Sử dụng HTML Hầu hết các bộ xử lý Markdown đều chấp nhận HTML table syntax:
<table>
<tr>
<th colspan="2">Merged Header</th>
</tr>
<tr>
<td>Cell 1</td>
<td>Cell 2</td>
</tr>
</table>Nội dung ô nhiều dòng
Sử dụng <br> Đối với các đứt đường bên trong ô (làm việc trên GitHub và hầu hết các nền tảng):
| Step | Description |
|---|---|
| 1 | Open the file<br>Make sure it's .docx format |
| 2 | Drop it on [WordToMD](/#converter) |Bàn lớn
Đối với các bảng có nhiều cột, hãy xem liệu một bảng có đúng định dạng hay không. Các lựa chọn thay thế:
- Danh sách định nghĩa (giới hạn + mô tả)
- Nhiều bảng nhỏ hơn theo loại
- Một khối mã cho dữ liệu có cấu trúc (JSON, YAML)
Định dạng bảng theo nền tảng
| Nền tảng | GFM Bảng | Định hướng | HTML Bảng |
|---|---|---|---|
| GitHub | ✅ | ✅ | ✅ |
| GitLab | ✅ | ✅ | ✅ |
| Notion | ✅ | ❌ | ❌ |
| Obsidian | ✅ | ✅ | ✅ |
| GitBook | ✅ | ✅ | ✅ |
| VS Code Preview | ✅ | ✅ | ✅ |
| Confluence (Markdown macro) | ✅ | ✅ | ✅ |
| Jekyll/Hugo/Astro | ✅ | ✅ | ✅ |
Phương tiện truy cập
Để dễ tiếp cận hơn, đảm bảo các bảng có một hàng tiêu đề với tên cột có ý nghĩa. Đọc màn hình sử dụng hàng tiêu đề để thông báo ngữ cảnh ô.
| Product | Price | Availability |
|---|---|---|
| Widget A | $9.99 | In stock |
| Widget B | $14.99 | Out of stock |Tránh sử dụng bảng cho mục đích bố trí chỉ sử dụng chúng cho dữ liệu bảng thực tế.
FAQ
Tại sao bảng render của tôi không hiển thị như văn bản đơn giản?
Dòng phân tách (đường |---|---| dòng) là bắt buộc. Nếu không có nó, trình phân tích sẽ không nhận ra cấu trúc bảng.
Tôi có thể có một cái bàn không có dòng tiêu đề không?
Không phải trong GFM tiêu chuẩn. Các dòng tiêu đề và phân tách là bắt buộc. Nếu bạn không muốn có tiêu đề hiển thị, hãy sử dụng tiêu đề trống: | | | với một hàng phân tách.
Tại sao bảng của tôi từ Word nhìn đúng trong WordToMD nhưng sai sau khi tôi dán chúng ở nơi khác? Vấn đề thường là không gian trắng trong ô hoặc ký tự ống không nhất quán. Hầu hết các trình hiển thị Markdown đều nhẹ nhàng, nhưng sao chép-mắc có thể giới thiệu các ký tự vô hình.
Làm thế nào để tôi tạo một bảng theo chương trình từ dữ liệu?
Thư viện như markdown-table (npm) hoặc Pythons tabulate có thể tạo Markdown bảng từ mảng. Điều này hữu ích cho việc chuyển đổi CSV hoặc dữ liệu cơ sở dữ liệu.
Hướng dẫn liên quan
- Markdown là gì? Markdown cơ bản
- Markdown Phân âm bảng tham khảo nhanh Trích dẫn tổng hợp đầy đủ
- Làm thế nào để chuyển đổi Word thành Markdown Hướng dẫn chuyển đổi đầy đủ
- DOCX đến Markdown với bảng Tập trung vào chuyển đổi bảng
Kết luận
Markdown bảng là mạnh mẽ để hiển thị dữ liệu có cấu trúc và được hỗ trợ rộng rãi trên tất cả các nền tảng chính. Đối với các bảng bắt đầu bằng Word, WordToMD tự động chuyển đổi chúng thành GFM cú pháp. Đối với bố cục phức tạp, sự thay thế HTML và các thủ thuật ở trên cung cấp cho bạn quyền kiểm soát bạn cần.