Mặc dù các mảng JSON phẳng cơ bản chuyển đổi sạch sẽ thành lưới Markdown, dữ liệu kỹ thuật phần mềm thực tế thường chứa mảng đa chiều, cây đối tượng lồng nhau, giá trị boolean và giá trị null. Cú pháp bảng Markdown về bản chất là hai chiều, dựa vào các hàng và cột đơn giản mà không có sự hỗ trợ nguyên bản cho các bảng phụ lồng nhau.
Chiến lược hiển thị JSON lồng nhau trong Markdown
Khi chuyển đổi các cấu trúc JSON phức tạp, Utiliome áp dụng các phương thức xử lý nhất quán để giữ nguyên dữ liệu gốc:
1. Chuỗi hóa nội dòng cho đối tượng lồng nhau
Utiliome không làm phẳng các đối tượng con thành các cột dot-notation. Thay vào đó, các đối tượng lồng nhau (ví dụ: { "user": { "name": "Alex", "location": { "city": "Seattle" } } }) được hiển thị trực tiếp dưới dạng chuỗi JSON thu gọn (JSON.stringify) bên trong ô:
| user |
| {"name":"Alex","location":{"city":"Seattle"}} |
Cách tiếp cận này giữ nguyên toàn bộ cấu trúc phân cấp ban đầu mà không làm biến đổi số lượng cột trong bảng.
2. Chuỗi hóa nội dòng cho các mảng phụ
Khi một thuộc tính đối tượng chứa một mảng hoặc danh sách nhúng (ví dụ: { "roles": ["admin", "editor", "billing"] }), Utiliome sẽ hiển thị mảng đó dưới dạng một chuỗi JSON thu gọn:
| Username |
roles |
| dev_user |
["admin","editor","billing"] |
3. Xử lý mượt mà các giá trị Null và Boolean
Các giá trị null, khóa chưa xác định và cờ boolean được hiển thị rõ ràng để tránh nhầm lẫn trong các bảng được tạo. Utiliome chuyển đổi các giá trị boolean true/false thành chuỗi văn bản thông qua String() và hiển thị các mục null dưới dạng chuỗi "null", trong khi các thuộc tính bị thiếu giữa các hàng được để trống để giữ cho các cột rõ ràng.
Định dạng phân cách bảng GFM tiêu chuẩn
GitHub-Flavored Markdown (GFM) sử dụng hàng phân cách tiêu đề (hàng thứ hai của bảng) để định hình lưới. Utiliome áp dụng dòng phân cách tiêu chuẩn |---| giúp bảng hiển thị đồng nhất và tương thích trên tất cả các trình kết xuất Markdown.
Tích hợp mượt mà với các không gian làm việc phổ biến của nhà phát triển
Kết quả được tạo bởi Utiliome tuân thủ nghiêm ngặt các quy chuẩn CommonMark và GFM, đảm bảo hiển thị hoàn hảo trên tất cả các nền tảng nhà phát triển và công cụ quản lý nội dung hiện đại:
- GitHub & GitLab: Dán trực tiếp vào các file
README.md, tóm tắt pull request, ghi chú phát hành và bình luận issue.
- Notion & Coda: Sao chép văn bản Markdown đã định dạng và dán trực tiếp vào các khối Notion, nơi nó tự động chuyển đổi thành các bảng cơ sở dữ liệu Notion nguyên bản.
- Jira & Confluence: Dán vào các tài liệu đặc tả kỹ thuật và mô tả báo cáo lỗi để hiển thị bảng rõ ràng tức thì.
- Bộ tạo trang tĩnh (Static Site Generators): Sao chép vào các file nội dung Markdown cho các trang web Hugo, Docusaurus, MkDocs, Astro và Next.js mà không gây ra lỗi phân tích cú pháp Markdown.
| JSON Construct |
Indented Input |
Minified Output |
Preservation Rule |
| Structural Whitespace |
{\n "a": 1,\n "b": 2\n} |
{"a":1,"b":2} |
Strips all spaces, tabs, and newlines outside quotes |
| String Literals |
{"msg": "Hello World\n!"} |
{"msg":"Hello World\n!"} |
Retains internal spaces and \n escapes verbatim |
| Object Keys (Sorted) |
{"z": 1, "a": {"d": 2, "c": 3}} |
{"a":{"c":3,"d":2},"z":1} |
Alphabetically sorts keys at every nesting level |
| Arrays (Sorted Mode) |
{"items": ["z", "a", "m"]} |
{"items":["z","a","m"]} |
Array element order is never altered |
| Special Own Keys |
{"__proto__": {"admin": false}} |
{"__proto__":{\"admin\":false}} |
Preserved safely as own property without prototype mutation |