Markdown (.md)
Markdown là ngôn ngữ đánh dấu nhẹ sử dụng cú pháp văn bản thuần (# tiêu đề, đậm, - danh sách) để tạo tài liệu có định dạng. Nó phổ biến nhất trên GitHub, tài liệu kỹ thuật và viết blog.
Loại MIME
application/x-ndjson
Loại
Văn bản
Nén
Không mất dữ liệu
Ưu điểm
- + Streamable — process one record at a time without loading the entire file
- + Appendable — add new records by appending lines
- + Works with Unix tools (grep, head, tail, wc)
- + Standard for Elasticsearch bulk, BigQuery, and data pipelines
Nhược điểm
- − No standard for the overall file (no top-level schema)
- − Cannot represent a single JSON object spanning multiple lines
- − Less compact than binary formats for large datasets
Khi nào nên dùng .NDJSON
Sử dụng Markdown cho README, tài liệu kỹ thuật, blog, ghi chú, wiki và bất kỳ nội dung nào cần chuyển đổi sang HTML mà vẫn giữ được tính dễ đọc ở dạng văn bản thuần.
Chi tiết kỹ thuật
Markdown chuyển đổi thành HTML: # thành
, đậm thành , liên kết thành . CommonMark định nghĩa đặc tả rõ ràng. GFM thêm bảng, danh sách tác vụ, gạch ngang và tự động liên kết.
Lịch sử
John Gruber và Aaron Swartz tạo Markdown vào năm 2004 dưới dạng định dạng viết cho web. CommonMark (2014) đã chuẩn hóa cú pháp. GitHub Flavored Markdown (GFM) thêm bảng, danh sách tác vụ và khối mã.