Front matter Markdown

Kiểm tra, chuyển đổi và tạo front matter ở đầu file Markdown — khối thiết lập mà Jekyll, Hugo, Astro, Next.js, Docusaurus và Obsidian đọc trước phần nội dung. Công cụ hiểu front matter dạng YAML (---), TOML (+++) và JSON, mọi thứ chạy ngay trên trình duyệt.

Các bước sử dụng

1. Dán tài liệu vào ô Markdown, hoặc dùng thanh nhập liệu ở đầu ô: Mở file, Dán, Dữ liệu mẫu (Ví dụ của công cụ này, Bài blog, README) và Xoá. Bạn cũng có thể kéo thả file .md hoặc .mdx vào ô. Dòng chữ dưới ô cho biết định dạng nhận ra được và nằm ở những dòng nào.
2. Mở thẻ Kiểm tra để xem từng lỗi kèm số dòng: sai cú pháp, thiếu title, ngày không theo chuẩn ISO, thẻ viết thành chuỗi có dấu phẩy, khoá bị trùng, hoặc BOM hay dòng trống nằm trước --- mở đầu. Chuyển giữa Bảng, JSON và Nội dung để xem các giá trị đã đọc hoặc phần bài viết không còn front matter.
3. Mở Chuyển đổi và chọn YAML, TOML hoặc JSON ở Chuyển sang. Với JSON, chọn thêm Kiểu JSON: Object { } trần (Hugo) hoặc Giữa hai dòng ;;;. Sau đó bấm Sao chép tài liệu, Tải .md, hoặc Dùng làm đầu vào để sửa tiếp kết quả.
4. Mở Tạo mới để viết front matter bằng biểu mẫu. Chọn Mẫu có sẵn (Chung, Jekyll, Hugo, Astro, Docusaurus hoặc Obsidian) và Định dạng, rồi điền Tiêu đề, Mô tả, Ngày — nút Bây giờ chèn thời điểm hiện tại kèm múi giờ của bạn — Thẻ và các trường khác. Slug tự đi theo tiêu đề khi bật Tự tạo từ tiêu đề. Những trường còn lại thêm ở Trường tuỳ chỉnh bằng nút Thêm trường. Muốn sửa front matter đang có trong tài liệu thì bấm Lấy từ tài liệu trước.
5. Bấm Áp dụng vào tài liệu để thay front matter cũ (hoặc chèn lên đầu nếu chưa có), hay Sao chép front matter để dán sang chỗ khác.
6. Mở Tách / Trích xuất: Chỉ nội dung cho phần bài viết không có front matter, còn Chỉ dữ liệu xuất riêng các giá trị dạng JSON, YAML hoặc TOML.

Mẹo

• Tên màu xám nhỏ cạnh mỗi trường là khoá mà mẫu sẽ ghi ra. Astro lưu ngày thành pubDate và ảnh thành heroImage, Hugo ghi images dạng danh sách, còn Jekyll đổi Bản nháp thành published: false.
• Giá trị tuỳ chỉnh được đọc như YAML: true, 42, [a, b] và {x: 1} giữ nguyên kiểu, còn lại là văn bản. Đặt giá trị trong dấu nháy ('42') nếu muốn giữ nó là văn bản.
• TOML không có giá trị null. Khi chuyển sang TOML, các khoá rỗng bị bỏ ra và được liệt kê trong cảnh báo thay vì làm hỏng file.
• Ngày giữ nguyên cách bạn viết: 2024-05-31 thành ngày TOML thật và khi chuyển ngược lại vẫn là 2024-05-31, không phải 2024-05-31T00:00:00.000Z.
• Thẻ viết kiểu tags: hugo, static site là một chuỗi, không phải hai thẻ. Hugo và Astro cần danh sách như [hugo, static site].

Front matter phải bắt đầu ngay dòng đầu tiên của file. Một dòng trống hay ký tự BOM vô hình trước --- là lý do phổ biến nhất khiến trang web hiện các thiết lập thành chữ thường. Kiểm tra cảnh báo cả hai trường hợp, còn Chuyển đổi hoặc Áp dụng vào tài liệu sẽ xoá chúng đi.

Câu hỏi thường gặp

Chuyển đổi có làm thay đổi nội dung bài viết không?

Không. Chỉ khối front matter được viết lại. Mọi thứ phía sau được giữ nguyên từng ký tự, kể cả kiểu xuống dòng Windows (CRLF), và khối mới dùng cùng kiểu xuống dòng với file của bạn.

Vì sao thứ tự khoá bị đổi sau khi chuyển sang TOML?

TOML bắt buộc các giá trị đơn phải đứng trước các bảng như [author], nên đối tượng lồng nhau bị dời xuống cuối. Dữ liệu vẫn như cũ — chuyển ngược lại YAML sẽ được đúng các giá trị ban đầu.

Công cụ hỗ trợ những kiểu front matter JSON nào?

Object { … } trần nằm ngay đầu file như Hugo dùng, và JSON nằm giữa hai dòng ;;;. Cả hai đều được tự nhận ra, và bạn có thể ghi ra kiểu nào tuỳ ý bằng Kiểu JSON.

Tài liệu của tôi có bị tải lên không?

Không. Việc đọc, chuyển đổi và tạo front matter đều diễn ra ngay trên trình duyệt của bạn; không có gì được gửi lên máy chủ.