Trình tạo bảng Markdown

Bảng Markdown thực sự là gì

Bảng Markdown không thuộc đặc tả Markdown gốc; chúng đến từ GitHub Flavored Markdown, phương ngữ được GitHub phổ biến và giờ đây được hỗ trợ ở gần như mọi nơi mà các lập trình viên viết lách. Cú pháp cố tình đơn giản dưới dạng văn bản thuần: các cột được ngăn cách bằng ký tự sổ đứng, dòng tiêu đề nằm trên cùng, và một dòng gạch ngang thứ hai phân tách tiêu đề khỏi phần thân. Vì nó chỉ là văn bản, một bảng Markdown vẫn dễ đọc ở dạng thô và sống sót qua thao tác sao chép-dán, các bản diff của hệ thống quản lý phiên bản và email theo cách mà một bảng HTML không bao giờ làm được.

Công cụ này loại bỏ sự nhàm chán của việc căn thẳng những dấu sổ đứng đó. Bạn dán các dòng dữ liệu thông thường, nó tự tìm ra các cột, và nó viết ra một bảng được hình thành đúng đắn với tiêu đề, dòng phân tách và mọi ô đều ở đúng chỗ.

Giải phẫu cú pháp

Một bảng tối thiểu trông như ba dòng. Dòng đầu tiên liệt kê các tiêu đề ngăn cách bằng dấu sổ đứng, ví dụ Name rồi một dấu sổ đứng rồi Role. Dòng thứ hai là dòng phân tách: một nhóm gạch ngang cho mỗi cột, như ba gạch ngang, một dấu sổ đứng, ba gạch ngang. Mọi dòng sau đó là một dòng dữ liệu dùng cùng khuôn dấu sổ đứng. Các dấu sổ đứng ngoài cùng ở đầu và cuối mỗi dòng là tùy chọn trong GFM, nhưng việc đưa chúng vào khiến văn bản thô dễ đọc hơn và đó là thứ mà bộ tạo này tạo ra.

Dòng phân tách làm nhiệm vụ kép: nó vừa báo hiệu rằng dòng phía trên là một tiêu đề, vừa thông qua vị trí của các dấu hai chấm khai báo cách mỗi cột được canh lề. Đó là lý do một bảng Markdown luôn cần tối thiểu một dòng tiêu đề và một dòng phân tách để có thể hiển thị.

Thiết lập canh lề cột

Canh lề nằm hoàn toàn ở các gạch ngang của dòng phân tách, được điều khiển bằng các dấu hai chấm. Một dấu hai chấm ở bên trái các gạch ngang canh cột sang trái, một dấu hai chấm ở cả hai bên canh giữa, và một dấu hai chấm ở bên phải canh sang phải. Vậy một cột canh giữa được viết là một dấu hai chấm, một vài gạch ngang, rồi một dấu hai chấm, trong khi một cột canh phải kết thúc bằng một dấu hai chấm. Canh phải là lựa chọn theo thông lệ cho các cột số để các chữ số xếp thẳng theo giá trị hàng.

Việc chọn Trái, Giữa hoặc Phải trong công cụ này sẽ viết các dấu hai chấm đó cho bạn trên toàn bộ bảng, nghĩa là canh lề hiển thị y hệt nhau trên GitHub, trong các bộ tạo tài liệu và trong bất kỳ trình xem GFM nào khác thay vì phụ thuộc vào thiết lập của người đọc.

Một ví dụ cụ thể

Hãy dán ba dòng ngăn cách bằng dấu phẩy, Name, Role, City ở trên cùng, theo sau là Ada Lovelace, Engineer, London và Grace Hopper, Admiral, New York. Với canh giữa được chọn, công cụ phát ra một dòng tiêu đề gồm ba tựa đề, một dòng phân tách trong đó các gạch ngang của mỗi cột được bọc trong dấu hai chấm, và hai dòng dữ liệu. Khi dán vào một tệp README trên GitHub, nó hiển thị thành một bảng ba cột gọn gàng với các giá trị được canh giữa, không cần đếm dấu sổ đứng bằng tay.

Thoát dấu sổ đứng và những điểm cần lưu ý khác

Dấu sổ đứng là ký tự ngăn cách cột, nên một dấu sổ đứng đứng nguyên bên trong một ô thông thường sẽ tách ô đó làm đôi và phá hỏng bảng. Công cụ này tự động thoát mọi dấu sổ đứng trong dữ liệu của bạn bằng cách viết nó dưới dạng một dấu gạch chéo ngược theo sau là một dấu sổ đứng, nên một giá trị như một biểu thức logic chứa ký hiệu OR vẫn nằm trong một ô và hiển thị đúng như mong đợi.

Có hai điều khác cần biết. Bảng Markdown không thể chứa ngắt dòng cứng bên trong một ô bằng phím Enter; nếu bạn cần một ngắt dòng trong một ô, bạn sẽ phải chèn một thẻ br tường minh, vì GFM cho phép HTML nội tuyến. Và mỗi dòng nên có cùng số cột như tiêu đề. Các ô thừa trong một dòng bị hầu hết trình hiển thị bỏ qua và các ô thiếu hiển thị thành ô trống, nên hãy giữ các dòng của bạn chữ nhật để có kết quả dự đoán được.

Dấu phân tách và giá trị trong dấu ngoặc kép

Dữ liệu thực không phải lúc nào cũng đến dưới dạng ngăn cách bằng dấu phẩy. Để dấu phân tách ở chế độ Tự động cho phép công cụ nhận diện liệu các dòng của bạn dùng dấu phẩy, tab hay dấu sổ đứng, nghĩa là một khối được sao chép thẳng từ một bảng tính (ngăn cách bằng tab) và một tệp CSV xuất ra (ngăn cách bằng dấu phẩy) đều chuyển đổi được mà không cần cấu hình. Bạn cũng có thể ép một dấu phân tách cụ thể khi việc tự động nhận diện có thể đoán sai, chẳng hạn dữ liệu vốn dĩ chứa nhiều dấu phẩy.

Các giá trị CSV trong dấu ngoặc kép cũng được xử lý đúng. Một dấu phẩy nằm trong dấu ngoặc kép được coi là một phần của giá trị, nên một trường như một mục ghi họ-trước trong ngoặc kép vẫn nằm trong một ô thay vì vỡ thành hai cột. Điều này quan trọng vì các bản xuất bảng tính thường xuyên đặt trong ngoặc kép bất kỳ giá trị nào tự nó chứa dấu phân tách.

Bảng Markdown hoạt động ở đâu, và ở đâu thì không

Bảng Markdown tỏa sáng trong bối cảnh lập trình và viết lách: các tệp README, issue và pull request trên GitHub và GitLab; các bộ tạo trang tĩnh và tài liệu; nhiều wiki và ứng dụng ghi chú; các công cụ chat như Slack và Discord trong những trường nhận biết Markdown của chúng; và các bình luận trên Reddit. Bất cứ nơi nào hỗ trợ GFM, một bảng được dán vào đều hoạt động ngay và vẫn dễ đọc ở dạng nguồn.

Tuy vậy, chúng không có mặt ở mọi nơi. Markdown thuần không có phần mở rộng GFM thì không hiểu các bảng, và một số trình hiển thị nhẹ bỏ qua chúng, trong trường hợp đó các dấu sổ đứng thô lộ ra. Bảng Markdown cũng thiếu khả năng kiểm soát kiểu dáng tinh vi, ô gộp và cấu trúc lồng nhau. Khi bạn cần định dạng chính xác, gộp cột, hay tạo kiểu phong phú, một bảng HTML là lựa chọn tốt hơn; khi bạn muốn một bảng gọn gàng, quản lý phiên bản được và con người đọc được, thì Markdown thắng thế.