Bạn đang đọc một file Kubernetes manifest, một GitHub Actions workflow, hay một file cấu hình Docker Compose — tất cả đều viết bằng YAML. Nhưng cái API bạn cần gọi lại chỉ nhận JSON. Hoặc ngược lại: bạn có sẵn một đống JSON từ API response và muốn chuyển sang YAML để viết vào config file cho gọn hơn.
Tool YAML ↔ JSON Converter này làm đúng một việc: chuyển đổi qua lại giữa hai định dạng đó — nhanh, chính xác, không mất dữ liệu.
YAML là gì? Khác gì so với JSON?
YAML (YAML Ain't Markup Language) là định dạng serialization dữ liệu được thiết kế để con người đọc dễ hơn JSON. Thay vì dùng dấu ngoặc nhọn và nháy kép, YAML dùng indentation (thụt lề) để thể hiện cấu trúc phân cấp.
Ví dụ cùng một dữ liệu viết theo hai định dạng:
| Định dạng | Nội dung |
|---|---|
| YAML | name: Nguyen Van A | age: 25 | skills: [JavaScript, Python] | address: {city: HCM, district: Q1} |
| JSON | {"name":"Nguyen Van A","age":25,"skills":["JavaScript","Python"],"address":{"city":"HCM","district":"Q1"}} |
Khi viết YAML thực tế, mỗi phần tử nằm trên một dòng riêng với thụt lề — trông gọn, dễ đọc hơn JSON nhiều, đặc biệt với file config dài hàng trăm dòng.
YAML vs JSON — nên dùng cái nào?
| Tiêu chí | YAML | JSON |
|---|---|---|
| Dễ đọc với người | ✅ Rất dễ — không có dấu ngoặc rườm rà | ⚠️ Khá dễ nếu được format, khó nếu minified |
| Hỗ trợ comment | ✅ Có (# comment) | ❌ Không hỗ trợ |
| Parse bởi máy | ⚠️ Phức tạp hơn, nhiều edge case | ✅ Đơn giản, phổ biến hơn |
| Dùng trong API | ❌ Hiếm | ✅ Tiêu chuẩn de facto |
| Dùng trong config | ✅ Phổ biến (K8s, Docker, GitHub Actions) | ⚠️ Có nhưng ít hơn |
| Hỗ trợ multiline string | ✅ Tích hợp sẵn (| và >) | ⚠️ Phải escape bằng \n |
| Dung lượng file | ⚠️ Thường lớn hơn một chút | ✅ Nhỏ hơn khi minified |
Tóm lại: YAML phù hợp để viết config tay vì dễ đọc và hỗ trợ comment. JSON phù hợp để truyền dữ liệu qua API vì parse nhanh và mọi ngôn ngữ đều hỗ trợ tốt. Hai định dạng bổ sung cho nhau — và đó là lý do tool convert này ra đời.
Cách sử dụng
- YAML → JSON: Dán nội dung YAML vào ô bên trái → nhấn Convert to JSON → nhận JSON ở ô bên phải.
- JSON → YAML: Dán nội dung JSON vào ô bên trái → nhấn Convert to YAML → nhận YAML ở ô bên phải.
- Tool tự động validate đầu vào trước khi convert — nếu YAML hoặc JSON bị lỗi cú pháp, bạn sẽ được thông báo ngay.
- Nhấn Copy để copy kết quả hoặc Download để lưu thành file.
Tình huống thực tế hay gặp
| Tình huống | Hướng convert |
|---|---|
| Có API response JSON, cần viết vào config Kubernetes hoặc Helm chart | JSON → YAML |
| Đồng nghiệp gửi file YAML, cần paste vào Postman body hoặc gọi API | YAML → JSON |
| Kiểm tra file docker-compose.yml có cấu trúc đúng rồi xem dạng JSON để debug | YAML → JSON |
| Convert package.json thành YAML để dùng trong tool chỉ nhận YAML | JSON → YAML |
| Đọc GitHub Actions workflow (.yml) khó hiểu, muốn xem dạng JSON quen thuộc hơn | YAML → JSON |
| Viết OpenAPI spec — bắt đầu bằng JSON rồi convert sang YAML để lưu vào repo | JSON → YAML |
Lưu ý khi chuyển đổi
- Comment YAML bị mất khi convert sang JSON: JSON không hỗ trợ comment, nên toàn bộ dòng
# commenttrong YAML sẽ bị bỏ qua trong quá trình convert. - Kiểu dữ liệu tự động trong YAML: YAML tự suy kiểu —
true,false, số nguyên, số thực đều được nhận diện tự động. Nếu muốn giữ nguyên dạng string, hãy bọc trong nháy kép:"true". - YAML multiline string: Ký tự
|(literal block) và>(folded block) sẽ được convert thành JSON string có ký tự xuống dòng hoặc dấu cách tương ứng. - Indent YAML phải nhất quán: YAML rất nhạy cảm với indentation — dùng space, không dùng tab, và số space mỗi cấp phải nhất quán trong toàn file.
Kết luận
YAML và JSON là hai "phương ngữ" của cùng một thế giới dữ liệu có cấu trúc — mỗi cái có chỗ mạnh riêng, và trong thực tế bạn sẽ phải làm việc với cả hai. Biết cách chuyển đổi nhanh giữa chúng là kỹ năng nhỏ nhưng tiết kiệm được không ít thời gian.
Xem thêm: JSON Formatter & Validator để làm đẹp JSON sau khi convert, hoặc JSON Diff để so sánh hai phiên bản JSON. Khám phá toàn bộ bộ công cụ tại codetuthub.com/tools.
0 Bình luận